Aracılığıyla paylaş

Items - List Lakehouses

  • Başvuru
Hizmet:
Lakehouse
API Sürümü:
v1

Belirtilen çalışma alanından göl evleri listesini döndürür.
Bu API, sayfalandırmadestekler.

İzinler

Arayan, görüntüleyici veya daha yüksek çalışma alanı rolüne sahip olmalıdır.

Gerekli Temsilci Kapsamları

Workspace.Read.All veya Workspace.ReadWrite.All

Microsoft Entra tarafından desteklenen kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik Destek
Kullanıcı Evet
Hizmet sorumlusu ve yönetilen kimlikler Evet

Arayüz

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/lakehouses
İsteğe bağlı parametrelerle: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/lakehouses?continuationToken={continuationToken}

URI Parametreleri

Name İçinde Gerekli Tür Description
workspaceId
 path True

string

uuid

Çalışma alanı kimliği.
continuationToken
 query

string

Sonuçların sonraki sayfasını almak için bir belirteç.

Yanıtlar

Name Tür Description
200 OK

Lakehouses

İstek başarıyla tamamlandı.
Other Status Codes

ErrorResponse

Yaygın hata kodları:

  • InvalidItemType - Geçersiz öğe türü

Örnekler

List lakehouses in workspace example

Örnek isteği

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/lakehouses

Örnek yanıt

Durum kodu:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse_1",
      "description": "A lakehouse description.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "properties": {
        "oneLakeTablesPath": "https://onelake.dfs.fabric.microsoft.com/2382cdf5-d577-44d0-a1fc-42184f29a7eb/e5fb215b-1934-413e-b33a-debaf844afde/Tables",
        "oneLakeFilesPath": "https://onelake.dfs.fabric.microsoft.com/2382cdf5-d577-44d0-a1fc-42184f29a7eb/e5fb215b-1934-413e-b33a-debaf844afde/Files",
        "sqlEndpointProperties": {
          "connectionString": "qvrmbuxie7we7glrekxgy6npqu-6xgyei3x2xiejip4iime6knh5m.datawarehouse.fabric.microsoft.com",
          "id": "37dc8a41-dea9-465d-b528-3e95043b2356",
          "provisioningStatus": "Success"
        }
      }
    },
    {
      "id": "a8a1bffa-7eea-49dc-a1d2-6281c1d031f1",
      "displayName": "Lakehouse_2",
      "description": "A lakehouse description.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "properties": {
        "oneLakeTablesPath": "https://onelake.dfs.fabric.microsoft.com/fc5d0537-1b22-4de1-a5e9-9b8bb58ed1e1/6dc325f6-46f6-4a2a-930b-10b96a463566/Tables",
        "oneLakeFilesPath": "https://onelake.dfs.fabric.microsoft.com/fc5d0537-1b22-4de1-a5e9-9b8bb58ed1e1/6dc325f6-46f6-4a2a-930b-10b96a463566/Files",
        "sqlEndpointProperties": {
          "connectionString": "qvrmbuxie7we7glrekxgy6npqu-6xgyei3x2xiejip4iime6knh5m.datawarehouse.fabric.microsoft.com",
          "id": "37dc8a41-dea9-465d-b528-3e95043b2356",
          "provisioningStatus": "Success"
        }
      }
    }
  ]
}

Tanımlar

Name Description
ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse

Hata yanıtı.
ErrorResponseDetails

Hata yanıtı ayrıntıları.
ItemType

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
Lakehouse

Göl evi öğesi.
LakehouseProperties

Göl evi özellikleri.
Lakehouses

Göl evleri listesi.
SqlEndpointProperties

SQL uç noktasının özelliklerini içeren bir nesne.
SqlEndpointProvisioningStatus

SQL uç noktası sağlama durum türü. Zaman içinde ek SqlEndpointProvisioningStatus türleri eklenebilir.

ErrorRelatedResource

Object

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name Tür Description
resourceId

string

Hataya dahil olan kaynak kimliği.
resourceType

string

Hataya dahil olan kaynağın türü.

ErrorResponse

Object

Hata yanıtı.

Name Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message

string

Hatanın okunabilir bir gösterimi.
moreDetails

ErrorResponseDetails[]

Ek hata ayrıntılarının listesi.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.
requestId

string

Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Object

Hata yanıtı ayrıntıları.

Name Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message

string

Hatanın okunabilir bir gösterimi.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.

ItemType

Listeleme

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer Description
Dashboard

PowerBI panosu.
DataPipeline

Veri işlem hattı.
Datamart

PowerBI datamart.
Environment

Bir ortam.
Eventhouse

Bir olay evi.
Eventstream

Bir olay akışı.
GraphQLApi

GraphQL öğesi için bir API.
KQLDashboard

KQL panosu.
KQLDatabase

KQL veritabanı.
KQLQueryset

KQL sorgu kümesi.
Lakehouse

Göl evi.
MLExperiment

Makine öğrenmesi denemesi.
MLModel

Makine öğrenmesi modeli.
MirroredDatabase

Yansıtılmış veritabanı.
MirroredWarehouse

Aynalı bir depo.
MountedDataFactory

Bir MountedDataFactory.
Notebook

Bir not defteri.
PaginatedReport

PowerBI sayfalandırılmış raporu.
Reflex

Bir refleks.
Report

PowerBI raporu.
SQLDatabase

A SQLDatabase.
SQLEndpoint

Bir SQL uç noktası.
SemanticModel

PowerBI anlam modeli.
SparkJobDefinition

Spark iş tanımı.
Warehouse

Bir depo.

Lakehouse

Object

Göl evi öğesi.

Name Tür Description
description

string

Öğe açıklaması.
displayName

string

Öğenin görünen adı.
id

string

uuid

Öğe kimliği.
properties

LakehouseProperties

Göl evi özellikleri.
type

ItemType

Öğe türü.
workspaceId

string

uuid

Çalışma alanı kimliği.

LakehouseProperties

Object

Göl evi özellikleri.

Name Tür Description
defaultSchema

string

Lakehouse'un varsayılan şeması. Bu özellik yalnızca şema etkin lakehouse için döndürülür.
oneLakeFilesPath

string

Lakehouse dosyaları dizinine giden OneLake yolu.
oneLakeTablesPath

string

Lakehouse tables dizinine giden OneLake yolu.
sqlEndpointProperties

SqlEndpointProperties

SQL uç noktasının özelliklerini içeren bir nesne.

Lakehouses

Object

Göl evleri listesi.

Name Tür Description
continuationToken

string

Sonraki sonuç kümesi toplu işleminin belirteci. Başka kayıt yoksa yanıttan kaldırılır.
continuationUri

string

Sonraki sonuç kümesi toplu işleminin URI'sini. Başka kayıt yoksa yanıttan kaldırılır.
value

Lakehouse[]

Göl evleri listesi.

SqlEndpointProperties

Object

SQL uç noktasının özelliklerini içeren bir nesne.

Name Tür Description
connectionString

string

SQL uç noktası bağlantı dizesi.
id

string

SQL uç noktası kimliği.
provisioningStatus

SqlEndpointProvisioningStatus

SQL uç noktası sağlama durumu.

SqlEndpointProvisioningStatus

Listeleme

SQL uç noktası sağlama durum türü. Zaman içinde ek SqlEndpointProvisioningStatus türleri eklenebilir.

Değer Description
Failed

SQL uç noktası sağlama başarısız oldu.
InProgress

SQL uç noktası sağlama işlemi devam ediyor.
Success

SQL uç noktası sağlama başarılı oldu.