Bagikan melalui

Items - Create Warehouse

  • Referensi
Layanan:
Warehouse
Versi API:
v1

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

API ini tidak mendukung pembuatan gudang dengan definisi.

Izin

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

Cakupan yang Didelegasikan yang Diperlukan

Warehouse.ReadWrite.All atau Item.ReadWrite.All

Keterbatasan

  • Untuk membuat gudang, ruang kerja harus berada pada kapasitas Fabric yang didukung. Untuk informasi selengkapnya, lihat: jenis lisensi Microsoft Fabric.

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

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 gudang. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
creationPayload

WarehouseCreationPayload

Payload pembuatan gudang. Gunakan creationPayload. Anda tidak dapat menggunakan definition atau creationPayload secara bersamaan.
description

string

Deskripsi gudang. Panjang maksimum adalah 256 karakter.

Respons

Nama Jenis Deskripsi
201 Created

Warehouse

Berhasil dibuat
202 Accepted

Permintaan diterima, provisi gudang 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 warehouse example
Create a warehouse example with payload

Create a warehouse example

Permintaan sampel

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

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description."
}

Respon sampel

Kode status:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "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 warehouse example with payload

Permintaan sampel

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

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "creationPayload": {
    "collationType": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8"
  }
}

Respon sampel

Kode status:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "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
CollationType

Koladasi gudang. collations tambahan dapat ditambahkan dari waktu ke waktu.
CreateWarehouseRequest

Buat payload permintaan gudang.
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.
Warehouse

Sebuah objek gudang.
WarehouseCreationPayload

Payload item gudang
WarehouseProperties

Properti item gudang.

CollationType

Enumeration

Koladasi gudang. collations tambahan dapat ditambahkan dari waktu ke waktu.

Nilai Deskripsi
Latin1_General_100_BIN2_UTF8

Kolae default - peka huruf besar/kecil (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

kolater tidak peka huruf besar/kecil (CI)

CreateWarehouseRequest

Objek

Buat payload permintaan gudang.

Nama Jenis Deskripsi
creationPayload

WarehouseCreationPayload

Payload pembuatan gudang. Gunakan creationPayload. Anda tidak dapat menggunakan definition atau creationPayload secara bersamaan.
description

string

Deskripsi gudang. Panjang maksimum adalah 256 karakter.
displayName

string

Nama tampilan gudang. 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.

Warehouse

Objek

Sebuah objek gudang.

Nama Jenis Deskripsi
description

string

Deskripsi item.
displayName

string

Nama tampilan item.
id

string

uuid

ID item.
properties

WarehouseProperties

Properti gudang.
type

ItemType

Jenis item.
workspaceId

string

uuid

ID ruang kerja.

WarehouseCreationPayload

Objek

Payload item gudang

Nama Jenis Deskripsi
collationType

CollationType

Jenis kolatasi default gudang.

WarehouseProperties

Objek

Properti item gudang.

Nama Jenis Deskripsi
collationType

CollationType

Jenis kolas gudang.
connectionString

string

String koneksi SQL yang terhubung ke ruang kerja yang berisi gudang ini.
createdDate

string

date-time

Tanggal dan waktu gudang dibuat.
lastUpdatedTime

string

date-time

Tanggal dan waktu gudang terakhir diperbarui