Freigeben über

Items - Create Lakehouse

  • Referenz
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 Anrufer muss Mitwirkender oder höherer Arbeitsbereichsrolle haben.

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.

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.

Beispiele

Create a lakehouse example
Create a lakehouse with schema example

Create a lakehouse example

Beispielanforderung

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

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

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.

ItemType

Enumeration

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

Wert Beschreibung
Dashboard

PowerBI-Dashboard.
DataPipeline

Eine Datenpipeline.
Datamart

PowerBI datamart.
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.
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.
Warehouse

Ein Lagerhaus.

Lakehouse

Objekt

Ein Seehauselement.

Name Typ Beschreibung
description

string

Die Elementbeschreibung.
displayName

string

Der Anzeigename des Elements.
id

string

uuid

Die Element-ID.
properties

LakehouseProperties

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