Items - Create Mirrored Database
在指定的工作區中建立鏡像資料庫。
此 API 不支援在沒有定義的情況下建立鏡像資料庫。
若要建立具有定義的鏡像資料庫，請參閱 鏡像資料庫定義 一文。
權限
呼叫端必須具有 參與者 工作區角色。
必要的委派範圍
MirroredDatabase.ReadWrite.All 或 Item.ReadWrite.All
Microsoft Entra 支援的身分識別
此 API 支援本節中列出的Microsoft 身分識別。
| 身份 | 支援 |
|---|---|
| 使用者 | 是的 |
| 服務主體 和 受控識別 | 是的 |
介面
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabasesURI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
工作區標識碼。 |
要求本文
| 名稱 | 必要 | 類型 | Description |
|---|---|---|---|
| definition | True |
鏡像資料庫公用定義。 |
|
| displayName | True |
string |
鏡像資料庫顯示名稱。 顯示名稱必須依照項目類型遵循命名規則。 |
| description |
string |
鏡像資料庫描述。 長度上限為 256 個字元。 |
|
| folderId |
string (uuid) |
資料夾識別碼。 如果未指定或 Null，則會使用工作區作為其資料夾來建立鏡像資料庫。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 201 Created |
已成功建立 |
|
| Other Status Codes |
常見的錯誤碼：
|
範例
Create a mirrored database with public definition example
範例要求
POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/mirroredDatabases
{
"displayName": "Mirrored database 1",
"description": "A mirrored database description",
"definition": {
"parts": [
{
"path": "mirroring.json",
"payload": "eyAicHJvcGVydGllcy..WJsZSIgfSB9IH0gXSB9IH0",
"payloadType": "InlineBase64"
}
]
}
}
範例回覆
{
"displayName": "Mirrored database 1",
"description": "A mirrored database description",
"type": "MirroredDatabase",
"workspaceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
"id": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2"
}定義
| 名稱 | Description |
|---|---|
|
Create |
建立鏡像資料庫要求承載。 |
|
Error |
錯誤相關的資源詳細資料物件。 |
|
Error |
錯誤回應。 |
|
Error |
錯誤回應詳細數據。 |
|
Item |
表示在專案上套用的標記。 |
|
Item |
專案的型別。 可能會隨著時間新增其他項目類型。 |
|
Mirrored |
鏡像資料庫專案。 |
|
Mirrored |
鏡像資料庫公用定義物件。 |
|
Mirrored |
鏡像資料庫定義部分物件。 |
|
Mirrored |
鏡像資料庫屬性。 |
|
Payload |
定義元件承載的類型。 可能會隨著時間新增其他承載類型。 |
|
Sql |
物件，包含 SQL 端點的屬性。 |
|
Sql |
SQL 端點布建狀態類型。 可能會隨著時間新增其他 |
CreateMirroredDatabaseRequest
建立鏡像資料庫要求承載。
| 名稱 | 類型 | Description |
|---|---|---|
| definition |
鏡像資料庫公用定義。 |
|
| description |
string |
鏡像資料庫描述。 長度上限為 256 個字元。 |
| displayName |
string |
鏡像資料庫顯示名稱。 顯示名稱必須依照項目類型遵循命名規則。 |
| folderId |
string (uuid) |
資料夾識別碼。 如果未指定或 Null，則會使用工作區作為其資料夾來建立鏡像資料庫。 |
ErrorRelatedResource
錯誤相關的資源詳細資料物件。
| 名稱 | 類型 | Description |
|---|---|---|
| resourceId |
string |
發生錯誤的資源識別碼。 |
| resourceType |
string |
發生錯誤的資源類型。 |
ErrorResponse
錯誤回應。
| 名稱 | 類型 | Description |
|---|---|---|
| errorCode |
string |
提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。 |
| message |
string |
錯誤的人類可讀取表示法。 |
| moreDetails |
其他錯誤詳細數據的清單。 |
|
| relatedResource |
錯誤相關的資源詳細數據。 |
|
| requestId |
string |
與錯誤相關聯的要求標識碼。 |
ErrorResponseDetails
錯誤回應詳細數據。
| 名稱 | 類型 | Description |
|---|---|---|
| errorCode |
string |
提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。 |
| message |
string |
錯誤的人類可讀取表示法。 |
| relatedResource |
錯誤相關的資源詳細數據。 |
ItemTag
表示在專案上套用的標記。
| 名稱 | 類型 | 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 |
一個本體論。 |
MirroredDatabase
鏡像資料庫專案。
| 名稱 | 類型 | Description |
|---|---|---|
| description |
string |
專案描述。 |
| displayName |
string |
項目顯示名稱。 |
| folderId |
string (uuid) |
資料夾識別碼。 |
| id |
string (uuid) |
項目標識碼。 |
| properties |
鏡像資料庫屬性。 |
|
| tags |
Item |
已套用標籤的清單。 |
| type |
項目類型。 |
|
| workspaceId |
string (uuid) |
工作區標識碼。 |
MirroredDatabaseDefinition
鏡像資料庫公用定義物件。
| 名稱 | 類型 | Description |
|---|---|---|
| parts |
定義元件的清單。 |
MirroredDatabaseDefinitionPart
鏡像資料庫定義部分物件。
| 名稱 | 類型 | Description |
|---|---|---|
| path |
string |
鏡像資料庫元件路徑。 |
| payload |
string |
鏡像資料庫元件承載。 |
| payloadType |
承載類型。 |
MirroredDatabaseProperties
鏡像資料庫屬性。
| 名稱 | 類型 | Description |
|---|---|---|
| defaultSchema |
string |
鏡像資料庫的默認架構。 此屬性只會針對在定義中啟用預設架構的鏡像資料庫傳回。 |
| oneLakeTablesPath |
string |
鏡像資料庫數據表目錄的 OneLake 路徑。 |
| sqlEndpointProperties |
物件，包含 SQL 端點的屬性。 |
PayloadType
定義元件承載的類型。 可能會隨著時間新增其他承載類型。
| 值 | Description |
|---|---|
| InlineBase64 |
內嵌基底 64。 |
SqlEndpointProperties
物件，包含 SQL 端點的屬性。
| 名稱 | 類型 | Description |
|---|---|---|
| connectionString |
string |
SQL 端點連接字串。 |
| id |
string |
SQL 端點標識碼。 |
| provisioningStatus |
SQL 端點布建狀態。 |
SqlEndpointProvisioningStatus
SQL 端點布建狀態類型。 可能會隨著時間新增其他 SqlEndpointProvisioningStatus 類型。
| 值 | Description |
|---|---|
| InProgress |
SQL 端點布建正在進行中。 |
| Success |
SQL 端點布建成功。 |
| Failed |
SQL 端點布建失敗。 |