Items - Get Lakehouse

Başvuru

Hizmet:: Lakehouse

API Sürümü:: v1

Belirtilen lakehouse'un özelliklerini döndürür.

İzinler

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

Gerekli Temsilci Kapsamları

Lakehouse.Read.All veya Lakehouse.ReadWrite.All veya Item.Read.All veya Item.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/{lakehouseId}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
lakehouseId	path	True	string uuid	Göl evi kimliği.
workspaceId	path	True	string uuid	Çalışma alanı kimliği.

Yanıtlar

Name	Tür	Description
200 OK	Lakehouse	İstek başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemNotFound - İstenen öğe bulunamadı.

Name

Tür

Description

200 OK

Lakehouse

İstek başarıyla tamamlandı.

Other Status Codes

ErrorResponse

Yaygın hata kodları:

ItemNotFound - İstenen öğe bulunamadı.

Örnekler

Get a lakehouse example

Get a lakehouse with schema example

Get a lakehouse example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/lakehouses/5b218778-e7a5-4d73-8187-f10824047715

Örnek yanıt

Durum kodu:: 200

{
  "displayName": "Lakehouse_1",
  "description": "A lakehouse description.",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "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"
    }
  }
}

Get a lakehouse with schema example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/lakehouses/5b218778-e7a5-4d73-8187-f10824047715

Örnek yanıt

Durum kodu:: 200

{
  "displayName": "Lakehouse_created_with_schema",
  "description": "A schema enabled lakehouse.",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "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"
    },
    "defaultSchema": "dbo"
  }
}

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.
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.

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.

Aracılığıyla paylaş

Items - Get Lakehouse

İzinler

Gerekli Temsilci Kapsamları

Microsoft Entra tarafından desteklenen kimlikler

Arayüz

URI Parametreleri

Yanıtlar

Örnekler

Get a lakehouse example

Örnek isteği

Örnek yanıt

Get a lakehouse with schema example

Örnek isteği

Örnek yanıt

Tanımlar

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemType

Lakehouse

LakehouseProperties

SqlEndpointProperties

SqlEndpointProvisioningStatus

Ek kaynaklar