Items - List Lakehouses

Reference

Služba:: Lakehouse

Verze rozhraní API:: v1

Vrátí seznam objektů lakehouse ze zadaného pracovního prostoru.
Toto rozhraní API podporuje stránkování.

Dovolení

Volající musí mít roli prohlížeče nebo vyšší.

Požadované delegovaná rozsahy

Workspace.Read.All nebo Workspace.ReadWrite.All

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Podpora
Uživatel	Ano
instančního objektu a spravované identity	Ano

Rozhraní

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/lakehouses

S volitelnými parametry:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/lakehouses?continuationToken={continuationToken}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
workspaceId	path	True	string uuid	ID pracovního prostoru.
continuationToken	query		string	Token pro načtení další stránky výsledků.

Odpovědi

Name	Typ	Description
200 OK	Lakehouses	Žádost byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Běžné kódy chyb: InvalidItemType – neplatný typ položky

Name

Typ

Description

200 OK

Lakehouses

Žádost byla úspěšně dokončena.

Other Status Codes

ErrorResponse

Běžné kódy chyb:

InvalidItemType – neplatný typ položky

Příklady

List lakehouses in workspace example

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
        }
      }
    }
  ]
}

Definice

Name	Description
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
ItemType	Typ položky. V průběhu času je možné přidat další typy položek.
Lakehouse	Položka jezera.
LakehouseProperties	Vlastnosti jezera.
Lakehouses	Seznam jezer.
SqlEndpointProperties	Objekt obsahující vlastnosti koncového bodu SQL.
SqlEndpointProvisioningStatus	Typ stavu zřizování koncového bodu SQL. V průběhu času je možné přidat další typy `SqlEndpointProvisioningStatus`.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

ItemType

Výčet

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota	Description
Dashboard	Řídicí panel PowerBI
DataPipeline	Datový kanál.
Datamart	Datový diagram PowerBI
Environment	Prostředí.
Eventhouse	Eventhouse.
Eventstream	Eventstream.
GraphQLApi	Rozhraní API pro položku GraphQL
KQLDashboard	Řídicí panel KQL.
KQLDatabase	Databáze KQL.
KQLQueryset	Sada dotazů KQL.
Lakehouse	Jezero.
MLExperiment	Experiment strojového učení.
MLModel	Model strojového učení.
MirroredDatabase	Zrcadlené databáze.
MirroredWarehouse	Zrcadlený sklad.
MountedDataFactory	A MountedDataFactory.
Notebook	Poznámkový blok.
PaginatedReport	Stránkovaná sestava PowerBI
Reflex	A Reflex.
Report	Sestava PowerBI
SQLDatabase	Databáze SQLDatabase.
SQLEndpoint	Koncový bod SQL.
SemanticModel	Sémantický model PowerBI
SparkJobDefinition	Definice úlohy Sparku.
Warehouse	Sklad.

Lakehouse

Objekt

Položka jezera.

Name	Typ	Description
description	string	Popis položky.
displayName	string	Zobrazovaný název položky.
id	string uuid	ID položky.
properties	LakehouseProperties	Vlastnosti jezera.
type	ItemType	Typ položky.
workspaceId	string uuid	ID pracovního prostoru.

LakehouseProperties

Objekt

Vlastnosti jezera.

Name	Typ	Description
defaultSchema	string	Výchozí schéma jezera. Tato vlastnost je vrácena pouze pro jezero s povoleným schématem.
oneLakeFilesPath	string	Cesta OneLake k adresáři souborů Lakehouse.
oneLakeTablesPath	string	Cesta OneLake k adresáři tabulek Lakehouse.
sqlEndpointProperties	SqlEndpointProperties	Objekt obsahující vlastnosti koncového bodu SQL.

Lakehouses

Objekt

Seznam jezer.

Name	Typ	Description
continuationToken	string	Token pro další dávku sady výsledků. Pokud neexistují žádné další záznamy, odebere se z odpovědi.
continuationUri	string	Identifikátor URI další dávky sady výsledků. Pokud neexistují žádné další záznamy, odebere se z odpovědi.
value	Lakehouse[]	Seznam jezer.

SqlEndpointProperties

Objekt

Objekt obsahující vlastnosti koncového bodu SQL.

Name	Typ	Description
connectionString	string	Připojovací řetězec koncového bodu SQL
id	string	ID koncového bodu SQL
provisioningStatus	SqlEndpointProvisioningStatus	Stav zřizování koncového bodu SQL

SqlEndpointProvisioningStatus

Výčet

Typ stavu zřizování koncového bodu SQL. V průběhu času je možné přidat další typy SqlEndpointProvisioningStatus.

Hodnota	Description
Failed	Zřizování koncového bodu SQL se nezdařilo.
InProgress	Probíhá zřizování koncových bodů SQL.
Success	Zřízení koncového bodu SQL bylo úspěšné.

Sdílet prostřednictvím

Items - List Lakehouses

Dovolení

Požadované delegovaná rozsahy

Podporované identity Microsoft Entra

Rozhraní

Parametry identifikátoru URI

Odpovědi

Příklady

List lakehouses in workspace example

Ukázkový požadavek

Ukázková odpověď

Definice

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemType

Lakehouse

LakehouseProperties

Lakehouses

SqlEndpointProperties

SqlEndpointProvisioningStatus

Další materiály