Items - Update Lakehouse

Layanan:

Lakehouse

Versi API:

v1

Memperbarui properti lakehouse yang ditentukan.

Izin

Pemanggil harus memiliki kontributor atau peran ruang kerja yang lebih tinggi.

Cakupan yang Didelegasikan yang Diperlukan

Lakehouse.ReadWrite.All atau Item.ReadWrite.All

Identitas yang didukung Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Dukung
Pengguna	Ya
perwakilan Layanan dan identitas terkelola	Ya

Antarmuka

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
lakehouseId	path	True	string uuid	Id lakehouse.
workspaceId	path	True	string uuid	ID ruang kerja.

Isi Permintaan

Nama	Jenis	Deskripsi
description	string	Deskripsi lakehouse. Panjang maksimum adalah 256 karakter.
displayName	string	Nama tampilan lakehouse. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.

Respons

Nama	Jenis	Deskripsi
200 OK	Lakehouse	Permintaan berhasil diselesaikan.
Other Status Codes	ErrorResponse	Kode kesalahan umum: ItemNotFound - Item yang diminta tidak ditemukan. InvalidRequest - Permintaan pembaruan tidak valid.

Contoh

Update a lakehouse example

Permintaan sampel

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

Respon sampel

Kode status:

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

Definisi

Nama	Deskripsi
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
ItemType	Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.
Lakehouse	Barang lakehouse.
LakehouseProperties	Properti lakehouse.
SqlEndpointProperties	Objek yang berisi properti titik akhir SQL.
SqlEndpointProvisioningStatus	Jenis status provisi titik akhir SQL. Jenis SqlEndpointProvisioningStatus tambahan dapat ditambahkan dari waktu ke waktu.
UpdateLakehouseRequest	Perbarui permintaan lakehouse.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.
requestId	string	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.

ItemType

Enumeration

Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Dashboard	Dasbor PowerBI.
DataPipeline	Alur data.
Datamart	Datamart PowerBI.
Environment	Lingkungan.
Eventhouse	Sebuah rumah acara.
Eventstream	Eventstream.
GraphQLApi	API untuk item GraphQL.
KQLDashboard	Dasbor KQL.
KQLDatabase	Database KQL.
KQLQueryset	Set kueri KQL.
Lakehouse	Sebuah lakehouse.
MLExperiment	Eksperimen pembelajaran mesin.
MLModel	Model pembelajaran mesin.
MirroredDatabase	Database cermin.
MirroredWarehouse	Sebuah gudang cermin.
MountedDataFactory	A MountedDataFactory.
Notebook	Buku catatan.
PaginatedReport	Laporan paginasi PowerBI.
Reflex	Sebuah Refleks.
Report	Laporan PowerBI.
SQLDatabase	Sebuah SQLDatabase.
SQLEndpoint	Titik akhir SQL.
SemanticModel	Model semantik PowerBI.
SparkJobDefinition	Definisi pekerjaan spark.
Warehouse	Sebuah gudang.

Lakehouse

Objek

Barang lakehouse.

Nama	Jenis	Deskripsi
description	string	Deskripsi item.
displayName	string	Nama tampilan item.
id	string uuid	ID item.
properties	LakehouseProperties	Properti lakehouse.
type	ItemType	Jenis item.
workspaceId	string uuid	ID ruang kerja.

LakehouseProperties

Objek

Properti lakehouse.

Nama	Jenis	Deskripsi
defaultSchema	string	Skema default lakehouse. Properti ini hanya dikembalikan untuk lakehouse yang diaktifkan skema.
oneLakeFilesPath	string	Jalur OneLake ke direktori file Lakehouse.
oneLakeTablesPath	string	Jalur OneLake ke direktori tabel Lakehouse.
sqlEndpointProperties	SqlEndpointProperties	Objek yang berisi properti titik akhir SQL.

SqlEndpointProperties

Objek

Objek yang berisi properti titik akhir SQL.

Nama	Jenis	Deskripsi
connectionString	string	String koneksi titik akhir SQL.
id	string	ID titik akhir SQL.
provisioningStatus	SqlEndpointProvisioningStatus	Status provisi titik akhir SQL.

SqlEndpointProvisioningStatus

Enumeration

Jenis status provisi titik akhir SQL. Jenis SqlEndpointProvisioningStatus tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Failed	Penyediaan titik akhir SQL gagal.
InProgress	Provisi titik akhir SQL sedang berlangsung.
Success	Provisi titik akhir SQL berhasil.

UpdateLakehouseRequest

Objek

Perbarui permintaan lakehouse.

Nama	Jenis	Deskripsi
description	string	Deskripsi lakehouse. Panjang maksimum adalah 256 karakter.
displayName	string	Nama tampilan lakehouse. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.