Baca dalam bahasa Inggris

Bagikan melalui

Items - Create Lakehouse

  • Referensi
Layanan:
Lakehouse
Versi API:
v1

Membuat lakehouse di ruang kerja yang ditentukan.
API ini mendukung operasi jangka panjang (LRO).

API ini tidak mendukung pembuatan lakehouse dengan definisi.

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

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
workspaceId
 path True

string

uuid

ID ruang kerja.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
displayName True

string

Nama tampilan lakehouse. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
creationPayload

LakehouseCreationPayload

Payload pembuatan lakehouse.
description

string

Deskripsi lakehouse. Panjang maksimum adalah 256 karakter.

Respons

Nama Jenis Deskripsi
201 Created

Lakehouse

Berhasil dibuat
202 Accepted

Permintaan diterima, provisi lakehouse sedang berlangsung.

Header

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

ErrorResponse

Kode kesalahan umum:

  • InvalidItemType - Tipe item tidak valid

  • ItemDisplayNameAlreadyInUse - Nama tampilan item sudah digunakan.

  • CorruptedPayload - Payload yang disediakan rusak.

Contoh

Create a lakehouse example
Create a lakehouse with schema example

Create a lakehouse example

Permintaan sampel

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

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

Respon sampel

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

Permintaan sampel

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

Respon sampel

Kode status:
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"
}
Kode status:
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

Definisi

Nama Deskripsi
CreateLakehouseRequest

Buat payload permintaan lakehouse.
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.
LakehouseCreationPayload

(Pratinjau) payload item Lakehouse. Properti ini saat ini diperlukan karena lakehouse yang diaktifkan skema sedang dalam pratinjau. Ini mungkin menjadi redundan pada Ketersediaan Umum (GA).
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.

CreateLakehouseRequest

Objek

Buat payload permintaan lakehouse.

Nama Jenis Deskripsi
creationPayload

LakehouseCreationPayload

Payload pembuatan lakehouse.
description

string

Deskripsi lakehouse. Panjang maksimum adalah 256 karakter.
displayName

string

Nama tampilan lakehouse. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.

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.

LakehouseCreationPayload

Objek

(Pratinjau) payload item Lakehouse. Properti ini saat ini diperlukan karena lakehouse yang diaktifkan skema sedang dalam pratinjau. Ini mungkin menjadi redundan pada Ketersediaan Umum (GA).

Nama Jenis Deskripsi
enableSchemas

boolean

Buat lakehouse yang diaktifkan skema saat diatur ke true. Hanya 'true' yang diizinkan.

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.