Jaa

Items - Create Lakehouse

  • Viite
Palvelu:
Lakehouse
Ohjelmointirajapinnan versio:
v1

Luo lakehousen määritettyyn työtilaan.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Tämä ohjelmointirajapinta ei tue lakehouse-tietovaraston luomista määritelmän avulla.

Käyttöoikeudet

Kutsujalla on oltava osallistujan tai suurempi työtilarooli.

Vaaditut delegoidut vaikutusalueet

Lakehouse.ReadWrite.All tai Item.ReadWrite.All

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kyllä

Rajapinta

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

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
workspaceId
 path True

string

uuid

Työtilan tunnus.

Pyynnön leipäteksti

Nimi Pakollinen Tyyppi Description
displayName True

string

Lakehouse-näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
creationPayload

LakehouseCreationPayload

Lakehousen luomus.
description

string

Lakehousen kuvaus. Enimmäispituus on 256 merkkiä.

Vastaukset

Nimi Tyyppi Description
201 Created

Lakehouse

Luonti onnistui
202 Accepted

Pyyntö hyväksytty, Lakehousen valmistelut käynnissä.

Otsikot

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

ErrorResponse

Yleiset virhekoodit:

  • InvalidItemType – Kohdetyyppi on virheellinen

  • ItemDisplayNameAlreadyInUse – Kohteen näyttönimi on jo käytössä.

  • VioittunutPayload – Annetut tiedot ovat vioittuneet.

Esimerkit

Create a lakehouse example
Create a lakehouse with schema example

Create a lakehouse example

Mallipyyntö

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

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

Mallivastaus

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

Mallipyyntö

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

Mallivastaus

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

Määritelmät

Nimi Description
CreateLakehouseRequest

Luo Lakehouse-pyynnön tiedot.
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.
ItemType

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.
Lakehouse

Lakehouse-esine.
LakehouseCreationPayload

(esikatselu) Lakehouse-kohteen tiedot. Tämä ominaisuus vaaditaan tällä hetkellä, koska rakenne käytössä lakehouse on esikatselussa. Se saattaa turhautua, kun se tulee yleisesti saataville.
LakehouseProperties

Lakehousen kiinteistöt.
SqlEndpointProperties

Objekti, joka sisältää SQL-päätepisteen ominaisuudet.
SqlEndpointProvisioningStatus

SQL-päätepisteiden valmistelun tilatyyppi. Muita SqlEndpointProvisioningStatus tyyppejä voidaan lisätä ajan kuluessa.

CreateLakehouseRequest

Object

Luo Lakehouse-pyynnön tiedot.

Nimi Tyyppi Description
creationPayload

LakehouseCreationPayload

Lakehousen luomus.
description

string

Lakehousen kuvaus. Enimmäispituus on 256 merkkiä.
displayName

string

Lakehouse-näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

Virhevastaus.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.
requestId

string

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Object

Virheen vastauksen tiedot.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

ItemType

Luettelointi

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
Dashboard

Power BI -koontinäyttö.
DataPipeline

Tietoputki.
Datamart

PowerBI -tietomarssi.
Environment

Ympäristö.
Eventhouse

Tapahtumatalo.
Eventstream

Tapahtumavirta.
GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.
KQLDashboard

KQL-koontinäyttö.
KQLDatabase

KQL-tietokanta.
KQLQueryset

KQL-kyselyjoukko.
Lakehouse

Tämä on lakehouse.
MLExperiment

Koneoppimisen kokeilu.
MLModel

Koneoppimismalli.
MirroredDatabase

Peilattu tietokanta.
MirroredWarehouse

Peilattu varasto.
MountedDataFactory

A MountedDataFactory.
Notebook

Muistikirja.
PaginatedReport

PowerBI:n sivutettu raportti.
Reflex

Refleksi.
Report

PowerBI -raportti.
SQLDatabase

A SQLDatabase.
SQLEndpoint

SQL-päätepiste.
SemanticModel

PowerBI:n semanttinen malli.
SparkJobDefinition

Spark-työn määritelmä.
Warehouse

Varasto.

Lakehouse

Object

Lakehouse-esine.

Nimi Tyyppi Description
description

string

Kohteen kuvaus.
displayName

string

Kohteen näyttönimi.
id

string

uuid

Kohdetunnus.
properties

LakehouseProperties

Lakehousen kiinteistöt.
type

ItemType

Kohdetyyppi.
workspaceId

string

uuid

Työtilan tunnus.

LakehouseCreationPayload

Object

(esikatselu) Lakehouse-kohteen tiedot. Tämä ominaisuus vaaditaan tällä hetkellä, koska rakenne käytössä lakehouse on esikatselussa. Se saattaa turhautua, kun se tulee yleisesti saataville.

Nimi Tyyppi Description
enableSchemas

boolean

Luo rakenne, joka on käytössä Lakehousessa, kun asetuksena on tosi. Vain true sallitaan.

LakehouseProperties

Object

Lakehousen kiinteistöt.

Nimi Tyyppi Description
defaultSchema

string

Lakehousen oletusrakenne. Tämä ominaisuus palautetaan vain rakenteessa käytössä olevan Lakehouse-ominaisuuden osalta.
oneLakeFilesPath

string

OneLake-polku Lakehouse-tiedostojen hakemistoon.
oneLakeTablesPath

string

OneLake-polku Lakehouse-taulukoiden hakemistoon.
sqlEndpointProperties

SqlEndpointProperties

Objekti, joka sisältää SQL-päätepisteen ominaisuudet.

SqlEndpointProperties

Object

Objekti, joka sisältää SQL-päätepisteen ominaisuudet.

Nimi Tyyppi Description
connectionString

string

SQL-päätepisteen yhteysmerkkijono.
id

string

SQL-päätepisteen tunnus.
provisioningStatus

SqlEndpointProvisioningStatus

SQL-päätepisteiden valmistelun tila.

SqlEndpointProvisioningStatus

Luettelointi

SQL-päätepisteiden valmistelun tilatyyppi. Muita SqlEndpointProvisioningStatus tyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
Failed

SQL-päätepisteiden valmistelu epäonnistui.
InProgress

SQL-päätepisteiden valmistelu on meneillään.
Success

SQL-päätepisteiden valmistelu onnistui.