Items - Create Lakehouse

Dienst:: Lakehouse

API-Version:: v1

Erstellt ein Seehaus im angegebenen Arbeitsbereich.
Diese API unterstützt LRO-.

Diese API unterstützt keine Erstellung eines Seehauses mit Definition.

Erlaubnisse

Der Aufrufer muss über eine Rolle des Mitwirkenden-Arbeitsbereichs verfügen.

Erforderliche delegierte Bereiche

Lakehouse.ReadWrite.All oder Item.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität	Unterstützen
Benutzer	Ja
Dienstprinzipal und verwaltete Identitäten	Ja

Schnittstelle

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
workspaceId	path	True	string (uuid)	Die Arbeitsbereichs-ID.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
displayName	True	string	Der Anzeigename des Seehauses. Der Anzeigename muss den Benennungsregeln entsprechend dem Elementtyp entsprechen.
creationPayload		LakehouseCreationPayload	Die Nutzlast der Lakehouse Creation.
description		string	Die Beschreibung des Seehauses. Die maximale Länge beträgt 256 Zeichen.
folderId		string (uuid)	Die Ordner-ID. Wenn sie nicht angegeben oder null ist, wird das Seehaus mit dem Arbeitsbereich als Ordner erstellt.

Antworten

Name	Typ	Beschreibung
201 Created	Lakehouse	Erfolgreich erstellt
202 Accepted		Anforderung akzeptiert, Seehausbereitstellung in Bearbeitung. Header Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Häufige Fehlercodes: InvalidItemType – Elementtyp ist ungültig. ItemDisplayNameAlreadyInUse - Der Anzeigename des Elements wird bereits verwendet. CorruptedPayload – Die bereitgestellte Nutzlast ist beschädigt. WorkspaceItemsLimitExceededed – Grenzwert für Arbeitsbereichselemente wurde überschritten.

Name

Typ

Beschreibung

201 Created

Lakehouse

Erfolgreich erstellt

202 Accepted

Anforderung akzeptiert, Seehausbereitstellung in Bearbeitung.

Header

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Häufige Fehlercodes:

InvalidItemType – Elementtyp ist ungültig.
ItemDisplayNameAlreadyInUse - Der Anzeigename des Elements wird bereits verwendet.
CorruptedPayload – Die bereitgestellte Nutzlast ist beschädigt.
WorkspaceItemsLimitExceededed – Grenzwert für Arbeitsbereichselemente wurde überschritten.

Beispiele

Create a lakehouse example

Create a lakehouse with schema example

Create a lakehouse example

Beispielanforderung

HTTP

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

{
  "displayName": "Lakehouse_1",
  "description": "A lakehouse description"
}

Beispiel für eine Antwort

Statuscode:: 201

{
  "displayName": "Lakehouse_1",
  "description": "A lakehouse description",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Statuscode:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a lakehouse with schema example

Beispielanforderung

HTTP

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

{
  "displayName": "Lakehouse_created_with_schema",
  "description": "A schema enabled lakehouse.",
  "creationPayload": {
    "enableSchemas": true
  }
}

Beispiel für eine Antwort

Statuscode:: 201

{
  "displayName": "Lakehouse_created_with_schema",
  "description": "A schema enabled lakehouse.",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Statuscode:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Definitionen

Name	Beschreibung
CreateLakehouseRequest	Erstellen Sie die Nutzlast der Lakehouse-Anforderung.
ErrorRelatedResource	Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse	Die Fehlerantwort.
ErrorResponseDetails	Die Fehlerantwortdetails.
ItemTag	Stellt ein Tag dar, das auf ein Element angewendet wird.
ItemType	Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.
Lakehouse	Ein Seehauselement.
LakehouseCreationPayload	(Vorschau) Lakehouse-Elementnutzlast. Diese Eigenschaft ist derzeit erforderlich, da das schemafähige Lakehouse in der Vorschau angezeigt wird. Sie kann bei allgemeiner Verfügbarkeit (GENERAL Availability, GA) redundant werden.
LakehouseProperties	Die Seehauseigenschaften.
SqlEndpointProperties	Ein Objekt, das die Eigenschaften des SQL-Endpunkts enthält.
SqlEndpointProvisioningStatus	Der SQL-Endpunktbereitstellungsstatustyp. Zusätzliche `SqlEndpointProvisioningStatus` Typen können im Laufe der Zeit hinzugefügt werden.

CreateLakehouseRequest

Objekt

Erstellen Sie die Nutzlast der Lakehouse-Anforderung.

Name	Typ	Beschreibung
creationPayload	LakehouseCreationPayload	Die Nutzlast der Lakehouse Creation.
description	string	Die Beschreibung des Seehauses. Die maximale Länge beträgt 256 Zeichen.
displayName	string	Der Anzeigename des Seehauses. Der Anzeigename muss den Benennungsregeln entsprechend dem Elementtyp entsprechen.
folderId	string (uuid)	Die Ordner-ID. Wenn sie nicht angegeben oder null ist, wird das Seehaus mit dem Arbeitsbereich als Ordner erstellt.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name	Typ	Beschreibung
resourceId	string	Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType	string	Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message	string	Eine lesbare Darstellung des Fehlers.
moreDetails	ErrorResponseDetails[]	Liste der zusätzlichen Fehlerdetails.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.
requestId	string	ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message	string	Eine lesbare Darstellung des Fehlers.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.

ItemTag

Objekt

Stellt ein Tag dar, das auf ein Element angewendet wird.

Name	Typ	Beschreibung
displayName	string	Der Name des Tags.
id	string (uuid)	Die Tag-ID.

ItemType

Enumeration

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.

Wert	Beschreibung
ApacheAirflowJob	Ein ApacheAirflowJob.
CopyJob	Ein Kopierauftrag.
Dashboard	PowerBI-Dashboard.
DataPipeline	Eine Datenpipeline.
Dataflow	Ein Datenfluss.
Datamart	PowerBI datamart.
DigitalTwinBuilder	Ein DigitalTwinBuilder.
DigitalTwinBuilderFlow	Ein Digital Twin Builder Flow.
Environment	Eine Umgebung.
Eventhouse	Ein Eventhouse.
Eventstream	Ein Ereignisstream.
GraphQLApi	Eine API für GraphQL-Element.
KQLDashboard	Ein KQL-Dashboard.
KQLDatabase	Eine KQL-Datenbank.
KQLQueryset	Ein KQL-Abfrageset.
Lakehouse	Ein Seehaus.
MLExperiment	Ein Machine Learning-Experiment.
MLModel	Ein Machine Learning-Modell.
MirroredAzureDatabricksCatalog	Ein gespiegelter Azure Databricks-Katalog.
MirroredDatabase	Eine gespiegelte Datenbank.
MirroredWarehouse	Ein gespiegeltes Lager.
MountedDataFactory	Eine MountedDataFactory.
Notebook	Ein Notizbuch.
PaginatedReport	PowerBI-Paginated-Bericht.
Reflex	Ein Reflex.
Report	PowerBI-Bericht.
SQLDatabase	Eine SQLDatabase.
SQLEndpoint	Ein SQL-Endpunkt.
SemanticModel	PowerBI-Semantikmodell.
SparkJobDefinition	Eine Sparkauftragsdefinition.
VariableLibrary	Eine VariableLibrary.
Warehouse	Ein Lagerhaus.
WarehouseSnapshot	Eine Warehouse-Momentaufnahme.

Lakehouse

Objekt

Ein Seehauselement.

Name	Typ	Beschreibung
description	string	Die Elementbeschreibung.
displayName	string	Der Anzeigename des Elements.
folderId	string (uuid)	Die Ordner-ID.
id	string (uuid)	Die Element-ID.
properties	LakehouseProperties	Die Seehauseigenschaften.
tags	ItemTag[]	Liste der angewendeten Tags.
type	ItemType	Der Elementtyp.
workspaceId	string (uuid)	Die Arbeitsbereichs-ID.

LakehouseCreationPayload

Objekt

(Vorschau) Lakehouse-Elementnutzlast. Diese Eigenschaft ist derzeit erforderlich, da das schemafähige Lakehouse in der Vorschau angezeigt wird. Sie kann bei allgemeiner Verfügbarkeit (GENERAL Availability, GA) redundant werden.

Name	Typ	Beschreibung
enableSchemas	boolean	Erstellen Sie ein Schema mit aktiviertem Lakehouse, wenn sie auf "true" festgelegt ist. Nur "true" ist zulässig.

LakehouseProperties

Objekt

Die Seehauseigenschaften.

Name	Typ	Beschreibung
defaultSchema	string	Standardschema des Seehauses. Diese Eigenschaft wird nur für schemafähiges Lakehouse zurückgegeben.
oneLakeFilesPath	string	OneLake-Pfad zum Verzeichnis der Lakehouse-Dateien.
oneLakeTablesPath	string	OneLake-Pfad zum Verzeichnis der Lakehouse-Tabellen.
sqlEndpointProperties	SqlEndpointProperties	Ein Objekt, das die Eigenschaften des SQL-Endpunkts enthält.

SqlEndpointProperties

Objekt

Ein Objekt, das die Eigenschaften des SQL-Endpunkts enthält.

Name	Typ	Beschreibung
connectionString	string	SQL-Endpunktverbindungszeichenfolge.
id	string	SQL-Endpunkt-ID.
provisioningStatus	SqlEndpointProvisioningStatus	Der Bereitstellungsstatus des SQL-Endpunkts.

SqlEndpointProvisioningStatus

Enumeration

Der SQL-Endpunktbereitstellungsstatustyp. Zusätzliche SqlEndpointProvisioningStatus Typen können im Laufe der Zeit hinzugefügt werden.

Wert	Beschreibung
Failed	Fehler bei der SQL-Endpunktbereitstellung.
InProgress	Die SQL-Endpunktbereitstellung wird ausgeführt.
Success	Die SQL-Endpunktbereitstellung war erfolgreich.

Freigeben über

Items - Create Lakehouse

Erlaubnisse

Erforderliche delegierte Bereiche

Von Microsoft Entra unterstützte Identitäten

Schnittstelle

URI-Parameter

Anforderungstext

Antworten

Beispiele

Create a lakehouse example

Beispielanforderung

Beispiel für eine Antwort

Create a lakehouse with schema example

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CreateLakehouseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

Lakehouse

LakehouseCreationPayload

LakehouseProperties

SqlEndpointProperties

SqlEndpointProvisioningStatus