Delen via

Items - Create Lakehouse

  • Referentie
Service:
Lakehouse
API-versie:
v1

Hiermee maakt u een lakehouse in de opgegeven werkruimte.
Deze API ondersteunt langlopende bewerkingen (LRO).

Deze API biedt geen ondersteuning voor het maken van een lakehouse met definitie.

Machtigingen

De aanroeper moet inzender hebben of een hogere werkruimterol.

Vereiste gedelegeerde bereiken

Lakehouse.ReadWrite.All of Item.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit Steunen
Gebruiker Ja
service-principal en beheerde identiteiten Ja

Interface

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

URI-parameters

Name In Vereist Type Description
workspaceId
 path True

string

uuid

De werkruimte-id.

Aanvraagbody

Name Vereist Type Description
displayName True

string

De weergavenaam van lakehouse. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.
creationPayload

LakehouseCreationPayload

De nettolading voor het maken van Lakehouse.
description

string

De beschrijving van lakehouse. De maximale lengte is 256 tekens.

Antwoorden

Name Type Description
201 Created

Lakehouse

Gemaakt
202 Accepted

Aanvraag geaccepteerd, inrichting van Lakehouse wordt uitgevoerd.

Kopteksten

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

  • InvalidItemType - Itemtype is ongeldig

  • ItemDisplayNameAlreadyInUse - Weergavenaam van item wordt al gebruikt.

  • CorruptedPayload: de opgegeven nettolading is beschadigd.

Voorbeelden

Create a lakehouse example
Create a lakehouse with schema example

Create a lakehouse example

Voorbeeldaanvraag

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

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
CreateLakehouseRequest

Maak de nettolading van lakehouse-aanvragen.
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

Het foutbericht.
ErrorResponseDetails

De details van het foutbericht.
ItemType

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
Lakehouse

Een lakehouse-item.
LakehouseCreationPayload

(preview) nettolading van Lakehouse-items. Deze eigenschap is momenteel vereist omdat het schema is ingeschakeld lakehouse als preview-versie. Deze kan redundant worden wanneer algemene beschikbaarheid (GA) wordt uitgevoerd.
LakehouseProperties

De lakehouse eigenschappen.
SqlEndpointProperties

Een object met de eigenschappen van het SQL-eindpunt.
SqlEndpointProvisioningStatus

Het inrichtingsstatustype van het SQL-eindpunt. Er kunnen in de loop van de tijd extra SqlEndpointProvisioningStatus typen worden toegevoegd.

CreateLakehouseRequest

Object

Maak de nettolading van lakehouse-aanvragen.

Name Type Description
creationPayload

LakehouseCreationPayload

De nettolading voor het maken van Lakehouse.
description

string

De beschrijving van lakehouse. De maximale lengte is 256 tekens.
displayName

string

De weergavenaam van lakehouse. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name Type Description
resourceId

string

De resource-id die betrokken is bij de fout.
resourceType

string

Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
moreDetails

ErrorResponseDetails[]

Lijst met aanvullende foutdetails.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.
requestId

string

Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.

ItemType

Inventarisatie

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde Description
Dashboard

PowerBI-dashboard.
DataPipeline

Een gegevenspijplijn.
Datamart

PowerBI-datamart.
Environment

Een omgeving.
Eventhouse

Een eventhouse.
Eventstream

Een eventstream.
GraphQLApi

Een API voor GraphQL-item.
KQLDashboard

Een KQL-dashboard.
KQLDatabase

Een KQL-database.
KQLQueryset

Een KQL-queryset.
Lakehouse

Een lakehouse.
MLExperiment

Een machine learning-experiment.
MLModel

Een machine learning-model.
MirroredDatabase

Een gespiegelde database.
MirroredWarehouse

Een gespiegeld magazijn.
MountedDataFactory

Een MountedDataFactory.
Notebook

Een notitieblok.
PaginatedReport

Gepagineerd Power BI-rapport.
Reflex

Een reflex.
Report

PowerBI-rapport.
SQLDatabase

Een SQLDatabase.
SQLEndpoint

Een SQL-eindpunt.
SemanticModel

Semantisch Power BI-model.
SparkJobDefinition

Een Spark-taakdefinitie.
Warehouse

Een magazijn.

Lakehouse

Object

Een lakehouse-item.

Name Type Description
description

string

De beschrijving van het item.
displayName

string

De weergavenaam van het item.
id

string

uuid

De item-id.
properties

LakehouseProperties

De lakehouse eigenschappen.
type

ItemType

Het itemtype.
workspaceId

string

uuid

De werkruimte-id.

LakehouseCreationPayload

Object

(preview) nettolading van Lakehouse-items. Deze eigenschap is momenteel vereist omdat het schema is ingeschakeld lakehouse als preview-versie. Deze kan redundant worden wanneer algemene beschikbaarheid (GA) wordt uitgevoerd.

Name Type Description
enableSchemas

boolean

Maak een schema waarvoor Lakehouse is ingeschakeld wanneer deze is ingesteld op true. Alleen 'waar' is toegestaan.

LakehouseProperties

Object

De lakehouse eigenschappen.

Name Type Description
defaultSchema

string

Standaardschema van het lakehouse. Deze eigenschap wordt alleen geretourneerd voor lakehouse waarvoor schema is ingeschakeld.
oneLakeFilesPath

string

OneLake-pad naar de map met Lakehouse-bestanden.
oneLakeTablesPath

string

OneLake-pad naar de map Met Lakehouse-tabellen.
sqlEndpointProperties

SqlEndpointProperties

Een object met de eigenschappen van het SQL-eindpunt.

SqlEndpointProperties

Object

Een object met de eigenschappen van het SQL-eindpunt.

Name Type Description
connectionString

string

Verbindingsreeks voor SQL-eindpunt.
id

string

SQL-eindpunt-id.
provisioningStatus

SqlEndpointProvisioningStatus

De inrichtingsstatus van het SQL-eindpunt.

SqlEndpointProvisioningStatus

Inventarisatie

Het inrichtingsstatustype van het SQL-eindpunt. Er kunnen in de loop van de tijd extra SqlEndpointProvisioningStatus typen worden toegevoegd.

Waarde Description
Failed

Inrichten van SQL-eindpunt is mislukt.
InProgress

Het inrichten van SQL-eindpunten wordt uitgevoerd.
Success

Het inrichten van SQL-eindpunten is voltooid.