Items - Update Lakehouse

Szolgáltatás:

Lakehouse

API-verzió:

v1

Frissíti a megadott tóház tulajdonságait.

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

Kötelező delegált hatókörök

Lakehouse.ReadWrite.All vagy Item.ReadWrite.All

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság	Támogat
Felhasználó	Igen
szolgáltatásnév és felügyelt identitások	Igen

Interfész

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
lakehouseId	path	True	string (uuid)	A lakehouse azonosítója.
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérelem törzse

Name	Típus	Description
description	string	A tóház leírása. A maximális hossz 256 karakter.
displayName	string	A lakehouse megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.

Válaszok

Name	Típus	Description
200 OK	Lakehouse	A kérés sikeresen befejeződött.
Other Status Codes	ErrorResponse	Gyakori hibakódok: ItemNotFound – A kért elem nem található. InvalidRequest – Érvénytelen frissítési kérelem.

Példák

Update a lakehouse example

Mintakérelem

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/lakehouses/5b218778-e7a5-4d73-8187-f10824047715

{
  "displayName": "Lakehouse_New_Name",
  "description": "A new description for lakehouse."
}

Mintaválasz

Állapotkód:

200

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

Definíciók

Name	Description
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
ItemType	Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
Lakehouse	Egy tóházi elem.
LakehouseProperties	A tóházi ingatlanok.
SqlEndpointProperties	Az SQL-végpont tulajdonságait tartalmazó objektum.
SqlEndpointProvisioningStatus	Az SQL-végpont kiépítési állapottípusa. Idővel további SqlEndpointProvisioningStatus típusok is hozzáadhatók.
UpdateLakehouseRequest	Frissítse a Lakehouse-kérést.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string	A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték	Description
CopyJob	Másolási feladat.
Dashboard	PowerBI-irányítópult.
DataPipeline	Egy adatfolyam.
Datamart	PowerBI datamart.
Environment	Egy környezet.
Eventhouse	Egy rendezvényház.
Eventstream	Eseménystream.
GraphQLApi	Api a GraphQL-elemhez.
KQLDashboard	KQL-irányítópult.
KQLDatabase	KQL-adatbázis.
KQLQueryset	KQL-lekérdezéskészlet.
Lakehouse	Egy tóház.
MLExperiment	Gépi tanulási kísérlet.
MLModel	Gépi tanulási modell.
MirroredDatabase	Tükrözött adatbázis.
MirroredWarehouse	Egy tükrözött raktár.
MountedDataFactory	A MountedDataFactory.
Notebook	Egy jegyzetfüzet.
PaginatedReport	Többoldalas PowerBI-jelentés.
Reflex	Egy reflex.
Report	PowerBI-jelentés.
SQLDatabase	A SQLDatabase.
SQLEndpoint	EGY SQL-végpont.
SemanticModel	PowerBI szemantikai modell.
SparkJobDefinition	Spark-feladat definíciója.
VariableLibrary	Egy VariableLibrary.
Warehouse	Egy raktár.

Lakehouse

Objektum

Egy tóházi elem.

Name	Típus	Description
description	string	Az elem leírása.
displayName	string	Az elem megjelenítendő neve.
folderId	string (uuid)	A mappa azonosítója.
id	string (uuid)	Az elem azonosítója.
properties	LakehouseProperties	A tóházi ingatlanok.
type	ItemType	Az elem típusa.
workspaceId	string (uuid)	A munkaterület azonosítója.

LakehouseProperties

Objektum

A tóházi ingatlanok.

Name	Típus	Description
defaultSchema	string	A lakehouse alapértelmezett sémája. Ez a tulajdonság csak séma-kompatibilis lakehouse esetén lesz visszaadva.
oneLakeFilesPath	string	A OneLake elérési útja a Lakehouse-fájlok könyvtárához.
oneLakeTablesPath	string	A OneLake elérési útja a Lakehouse-táblák könyvtárához.
sqlEndpointProperties	SqlEndpointProperties	Az SQL-végpont tulajdonságait tartalmazó objektum.

SqlEndpointProperties

Objektum

Az SQL-végpont tulajdonságait tartalmazó objektum.

Name	Típus	Description
connectionString	string	SQL-végpont kapcsolati sztringje.
id	string	SQL-végpont azonosítója.
provisioningStatus	SqlEndpointProvisioningStatus	Az SQL-végpont kiépítési állapota.

SqlEndpointProvisioningStatus

Enumerálás

Az SQL-végpont kiépítési állapottípusa. Idővel további SqlEndpointProvisioningStatus típusok is hozzáadhatók.

Érték	Description
Failed	Az SQL-végpont kiépítése nem sikerült.
InProgress	Az SQL-végpont kiépítése folyamatban van.
Success	Az SQL-végpont kiépítése sikeres volt.

UpdateLakehouseRequest

Objektum

Frissítse a Lakehouse-kérést.

Name	Típus	Description
description	string	A tóház leírása. A maximális hossz 256 karakter.
displayName	string	A lakehouse megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.