共用方式為

Items - Create Warehouse

服務:
Warehouse
API 版本:
v1

在指定的工作區中建立倉儲。
此 API 支援 長時間執行的作業 （LRO）。

此 API 不支援使用定義建立倉儲。

權限

呼叫端必須具有 參與者 工作區角色。

必要的委派範圍

Warehouse.ReadWrite.All 或 Item.ReadWrite.All

局限性

  • 若要建立倉儲，工作區必須位於支援的網狀架構容量上。 如需詳細資訊，請參閱：Microsoft Fabric 授權類型。

Microsoft Entra 支援的身分識別

此 API 支援本節中列出的Microsoft 身分識別。

身份 支援
使用者 是的
服務主體 和 受控識別 是的

介面

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

URI 參數

名稱 位於 必要 類型 Description
workspaceId
 path True

string (uuid)

工作區標識碼。

要求本文

名稱 必要 類型 Description
displayName True

string

倉儲顯示名稱。 顯示名稱必須依照項目類型遵循命名規則。
creationPayload

WarehouseCreationPayload

倉儲建立承載。 使用 creationPayload。 您無法同時使用 definition 或 creationPayload。
description

string

倉儲描述。 長度上限為 256 個字元。
folderId

string (uuid)

資料夾識別碼。 如果未指定或 Null，則會使用工作區作為其資料夾來建立倉儲。

回應

名稱 類型 Description
201 Created

Warehouse

已成功建立
202 Accepted

要求已接受，正在進行倉儲布建。

標題

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

服務費率上限被超標。 伺服器會回傳一個 Retry-After 標頭，以秒數表示客戶端在發送額外請求前必須等待多久。

標題

Retry-After: integer
Other Status Codes

ErrorResponse

常見的錯誤碼：

  • InvalidItemType - 項目類型無效。

  • ItemDisplayNameAlreadyInUse - 已使用項目顯示名稱。

  • CorruptedPayload - 提供的承載已損毀。

  • WorkspaceItemsLimitExceeded - 超過工作區專案限制。

範例

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

範例要求

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

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

範例回覆

狀態碼:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
狀態碼:
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

範例要求

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

範例回覆

狀態碼:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
狀態碼:
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

定義

名稱 Description
CollationType

倉儲定序。 可能會隨著時間新增其他 collations。
CreateWarehouseRequest

建立倉儲要求承載。
ErrorRelatedResource

錯誤相關的資源詳細資料物件。
ErrorResponse

錯誤回應。
ErrorResponseDetails

錯誤回應詳細數據。
ItemTag

表示在專案上套用的標記。
ItemType

專案的型別。 可能會隨著時間新增其他項目類型。
Warehouse

倉儲物件。
WarehouseCreationPayload

倉儲項目承載
WarehouseProperties

倉儲項目屬性。

CollationType

列舉型別

倉儲定序。 可能會隨著時間新增其他 collations。

值 Description
Latin1_General_100_BIN2_UTF8

預設值 - 區分大小寫 （CS） 定序
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

不區分大小寫 （CI） 定序

CreateWarehouseRequest

Object

建立倉儲要求承載。

名稱 類型 Description
creationPayload

WarehouseCreationPayload

倉儲建立承載。 使用 creationPayload。 您無法同時使用 definition 或 creationPayload。
description

string

倉儲描述。 長度上限為 256 個字元。
displayName

string

倉儲顯示名稱。 顯示名稱必須依照項目類型遵循命名規則。
folderId

string (uuid)

資料夾識別碼。 如果未指定或 Null，則會使用工作區作為其資料夾來建立倉儲。

ErrorRelatedResource

Object

錯誤相關的資源詳細資料物件。

名稱 類型 Description
resourceId

string

發生錯誤的資源識別碼。
resourceType

string

發生錯誤的資源類型。

ErrorResponse

Object

錯誤回應。

名稱 類型 Description
errorCode

string

提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message

string

錯誤的人類可讀取表示法。
moreDetails

ErrorResponseDetails[]

其他錯誤詳細數據的清單。
relatedResource

ErrorRelatedResource

錯誤相關的資源詳細數據。
requestId

string (uuid)

與錯誤相關聯的要求標識碼。

ErrorResponseDetails

Object

錯誤回應詳細數據。

名稱 類型 Description
errorCode

string

提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message

string

錯誤的人類可讀取表示法。
relatedResource

ErrorRelatedResource

錯誤相關的資源詳細數據。

ItemTag

Object

表示在專案上套用的標記。

名稱 類型 Description
displayName

string

標籤的名稱。
id

string (uuid)

標記標識碼。

ItemType

列舉型別

專案的型別。 可能會隨著時間新增其他項目類型。

值 Description
Dashboard

PowerBI 儀錶板。
Report

PowerBI 報表。
SemanticModel

PowerBI 語意模型。
PaginatedReport

PowerBI 編頁報表。
Datamart

PowerBI datamart。
Lakehouse

湖屋
Eventhouse

事件屋。
Environment

環境。
KQLDatabase

KQL 資料庫。
KQLQueryset

KQL 查詢集。
KQLDashboard

KQL 儀錶板。
DataPipeline

數據管線。
Notebook

筆記本。
SparkJobDefinition

Spark 作業定義。
MLExperiment

機器學習實驗。
MLModel

機器學習模型。
Warehouse

倉儲。
Eventstream

eventstream。
SQLEndpoint

SQL 端點。
MirroredWarehouse

鏡像倉儲。
MirroredDatabase

鏡像資料庫。
Reflex

反射。
GraphQLApi

GraphQL 專案的 API。
MountedDataFactory

MountedDataFactory。
SQLDatabase

SQLDatabase。
CopyJob

複製作業。
VariableLibrary

VariableLibrary。
Dataflow

數據流。
ApacheAirflowJob

ApacheAirflowJob。
WarehouseSnapshot

倉儲快照集。
DigitalTwinBuilder

DigitalTwinBuilder。
DigitalTwinBuilderFlow

數字對應項產生器流程。
MirroredAzureDatabricksCatalog

鏡像的 Azure databricks 目錄。
Map

一張地圖。
AnomalyDetector

異常偵測器。
UserDataFunction

使用者資料函數。
GraphModel

GraphModel 的 GraphModel。
GraphQuerySet

圖形 QuerySet。
SnowflakeDatabase

一個 Snowflake 資料庫，用來儲存由 Snowflake 帳號建立的 Iceberg 表格。
OperationsAgent

一個行動特工。
CosmosDBDatabase

一個 Cosmos 資料庫。
Ontology

一個本體論。
EventSchemaSet

一個事件結構集。
DataAgent

一個資料代理人。

Warehouse

Object

倉儲物件。

名稱 類型 Description
description

string

專案描述。
displayName

string

項目顯示名稱。
folderId

string (uuid)

資料夾識別碼。
id

string (uuid)

項目標識碼。
properties

WarehouseProperties

倉儲屬性。
tags

ItemTag[]

已套用標籤的清單。
type

ItemType

項目類型。
workspaceId

string (uuid)

工作區標識碼。

WarehouseCreationPayload

Object

倉儲項目承載

名稱 類型 Description
collationType

CollationType

倉儲的預設定序類型。

WarehouseProperties

Object

倉儲項目屬性。

名稱 類型 Description
collationType

CollationType

倉儲的定序類型。
connectionString

string

線上到包含此倉儲之工作區的 SQL 連接字串。
createdDate

string (date-time)

建立倉儲的日期和時間。
lastUpdatedTime

string (date-time)

上次更新倉儲的日期和時間