Del via

Items - Create Lakehouse

  • Referanse
Tjeneste:
Lakehouse
API-versjon:
v1

Oppretter et lakehouse i det angitte arbeidsområdet.
Denne API-en støtter langvarige operasjoner (LRO).

Denne API-en støtter ikke oppretting av et lakehouse med definisjon.

Tillatelser

Innringeren må ha bidragsyter eller høyere arbeidsområderolle.

Nødvendige delegerte omfang

Lakehouse.ReadWrite.All eller Item.ReadWrite.All

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet Støtte
Bruker Ja
tjenestekontohaver og administrerte identiteter Ja

Grensesnitt

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

URI-parametere

Navn I Obligatorisk Type Beskrivelse
workspaceId
 path True

string

uuid

Arbeidsområde-ID-en.

Brødtekst for forespørsel

Navn Obligatorisk Type Beskrivelse
displayName True

string

Navnet på lakehouse-visningsnavnet. Visningsnavnet må følge navnereglene i henhold til elementtype.
creationPayload

LakehouseCreationPayload

Lakehouse opprettelse nyttelast.
description

string

Beskrivelsen av lakehouse. Maksimal lengde er 256 tegn.

Svar

Navn Type Beskrivelse
201 Created

Lakehouse

Opprettet
202 Accepted

Forespørsel akseptert, lakehouse klargjøring pågår.

Overskrifter

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

ErrorResponse

Vanlige feilkoder:

  • InvalidItemType – elementtypen er ugyldig

  • ItemDisplayNameAlreadyInUse – visningsnavnet for elementet er allerede brukt.

  • CorruptedPayload – den angitte nyttelasten er skadet.

Eksempler

Create a lakehouse example
Create a lakehouse with schema example

Create a lakehouse example

Eksempelforespørsel

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

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

Eksempelsvar

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

Eksempelforespørsel

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

Eksempelsvar

Statuskode:
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"
}
Statuskode:
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

Definisjoner

Navn Beskrivelse
CreateLakehouseRequest

Opprett lakehouse forespørsel nyttelast.
ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.
ErrorResponse

Feilsvaret.
ErrorResponseDetails

Feilsvardetaljene.
ItemType

Typen element. Flere elementtyper kan legges til over tid.
Lakehouse

Et lakehouse-element.
LakehouseCreationPayload

(forhåndsversjon) lakehouse-nyttelast. Denne egenskapen kreves for øyeblikket på grunn av at skjemaaktivert lakehouse er i forhåndsversjon. Det kan bli overflødig ved generell tilgjengelighet (GA).
LakehouseProperties

Lakehouse egenskaper.
SqlEndpointProperties

Et objekt som inneholder egenskapene til SQL-endepunktet.
SqlEndpointProvisioningStatus

Statustypen klargjøring av SQL-endepunkt. Flere SqlEndpointProvisioningStatus typer kan legges til over tid.

CreateLakehouseRequest

Object

Opprett lakehouse forespørsel nyttelast.

Navn Type Beskrivelse
creationPayload

LakehouseCreationPayload

Lakehouse opprettelse nyttelast.
description

string

Beskrivelsen av lakehouse. Maksimal lengde er 256 tegn.
displayName

string

Navnet på lakehouse-visningsnavnet. Visningsnavnet må følge navnereglene i henhold til elementtype.

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn Type Beskrivelse
resourceId

string

Ressurs-ID-en som er involvert i feilen.
resourceType

string

Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
moreDetails

ErrorResponseDetails[]

Liste over flere feildetaljer.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.
requestId

string

ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.

ItemType

Opplisting

Typen element. Flere elementtyper kan legges til over tid.

Verdi Beskrivelse
Dashboard

PowerBI-instrumentbord.
DataPipeline

Et datasamlebånd.
Datamart

PowerBI-datamart.
Environment

Et miljø.
Eventhouse

Et arrangementshus.
Eventstream

En hendelsesstrøm.
GraphQLApi

En API for GraphQL-element.
KQLDashboard

Et KQL-instrumentbord.
KQLDatabase

En KQL-database.
KQLQueryset

Et KQL-spørringssett.
Lakehouse

Et innsjøhus.
MLExperiment

Et maskinlæringseksperiment.
MLModel

En maskinlæringsmodell.
MirroredDatabase

En speilvendt database.
MirroredWarehouse

Et speilvendt lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notatblokk.
PaginatedReport

Paginert powerbi-rapport.
Reflex

En refleks.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

Et SQL-endepunkt.
SemanticModel

Semantisk PowerBI-modell.
SparkJobDefinition

En spark-jobbdefinisjon.
Warehouse

Et lager.

Lakehouse

Object

Et lakehouse-element.

Navn Type Beskrivelse
description

string

Elementbeskrivelsen.
displayName

string

Visningsnavnet for elementet.
id

string

uuid

Element-ID-en.
properties

LakehouseProperties

Lakehouse egenskaper.
type

ItemType

Elementtypen.
workspaceId

string

uuid

Arbeidsområde-ID-en.

LakehouseCreationPayload

Object

(forhåndsversjon) lakehouse-nyttelast. Denne egenskapen kreves for øyeblikket på grunn av at skjemaaktivert lakehouse er i forhåndsversjon. Det kan bli overflødig ved generell tilgjengelighet (GA).

Navn Type Beskrivelse
enableSchemas

boolean

Opprett et skjemaaktivert lakehouse når det er satt til sann. Bare «sann» er tillatt.

LakehouseProperties

Object

Lakehouse egenskaper.

Navn Type Beskrivelse
defaultSchema

string

Standardskjema for lakehouse. Denne egenskapen returneres bare for skjemaaktivert lakehouse.
oneLakeFilesPath

string

OneLake-banen til Lakehouse-filkatalogen.
oneLakeTablesPath

string

OneLake-banen til Lakehouse-tabellkatalogen.
sqlEndpointProperties

SqlEndpointProperties

Et objekt som inneholder egenskapene til SQL-endepunktet.

SqlEndpointProperties

Object

Et objekt som inneholder egenskapene til SQL-endepunktet.

Navn Type Beskrivelse
connectionString

string

Tilkoblingsstreng for SQL-endepunkt.
id

string

SQL-endepunkt-ID.
provisioningStatus

SqlEndpointProvisioningStatus

Klargjøringsstatus for SQL-endepunkt.

SqlEndpointProvisioningStatus

Opplisting

Statustypen klargjøring av SQL-endepunkt. Flere SqlEndpointProvisioningStatus typer kan legges til over tid.

Verdi Beskrivelse
Failed

Klargjøring av SQL-endepunkt mislyktes.
InProgress

KLARgjøring av SQL-endepunkt pågår.
Success

KLARgjøring av SQL-endepunkt er fullført.