Items - Get Mirrored Azure Databricks Catalog

服務:: MirroredAzureDatabricksCatalog

API 版本:: v1

備註

此 API 處於預覽狀態。

傳回指定之 mirroredAzureDatabricksCatalog 的屬性。

權限

呼叫端必須具有鏡像 Azure databricks 目錄的讀取許可權。

必要的委派範圍

MirroredAzureDatabricksCatalog.Read.All 或 MirroredAzureDatabricksCatalog.ReadWrite.All 或 Item.Read.All 或 Item.ReadWrite.All

Microsoft Entra 支援的身份識別

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

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

介面

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredAzureDatabricksCatalogs/{mirroredAzureDatabricksCatalogId}

URI 參數

名稱	位於	必要	類型	Description
mirroredAzureDatabricksCatalogId	path	True	string (uuid)	mirroredAzureDatabricksCatalog 標識符。
workspaceId	path	True	string (uuid)	工作區識別碼。

回應

名稱	類型	Description
200 OK	MirroredAzureDatabricksCatalog	要求成功完成。
Other Status Codes	ErrorResponse	常見的錯誤碼： ItemNotFound - 找不到要求的專案。

名稱

類型

Description

200 OK

MirroredAzureDatabricksCatalog

要求成功完成。

Other Status Codes

ErrorResponse

常見的錯誤碼：

ItemNotFound - 找不到要求的專案。

範例

Get a mirroredAzureDatabricksCatalog example

範例要求

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/mirroredAzureDatabricksCatalogs/5b218778-e7a5-4d73-8187-f10824047715

範例回覆

狀態碼:: 200

{
  "id": "3546052c-ae64-4526-b1a8-52af7761426f",
  "displayName": "MirroredAzureDatabricksCatalog_1",
  "description": "A MirroredAzureDatabricksCatalog description.",
  "type": "MirroredAzureDatabricksCatalog",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "properties": {
    "catalogName": "catalog_1",
    "mirroringMode": "Full",
    "databricksWorkspaceConnectionId": "c1128f28-d84f-417c-8234-0feb91e35f86",
    "oneLakeTablesPath": "https://onelake.dfs.fabric.microsoft.com/2382cdf5-d577-44d0-a1fc-42184f29a7eb/e5fb215b-1934-413e-b33a-debaf844afde/Tables",
    "sqlEndpointProperties": {
      "connectionString": "qvrmbuxie7we7glrekxgy6npqu-6xgyei3x2xiejip4iime6knh5m.datawarehouse.fabric.microsoft.com",
      "id": "37dc8a41-dea9-465d-b528-3e95043b2356"
    },
    "syncDetails": {
      "status": "Success",
      "lastSyncDateTime": "2024-12-26T09:40:38.8583698Z",
      "errorInfo": null
    },
    "mirrorStatus": "Mirrored",
    "autoSync": "Enabled",
    "storageConnectionId": "c1128f28-d84f-417c-8234-0feb91e35f86"
  }
}

定義

名稱	Description
AutoSync	啟用或停用目錄的自動同步處理。啟用時，所有元數據變更，包括架構和數據表，都會每隔 15 分鐘自動同步處理一次。停用時，用戶必須手動重新整理元數據。此設定只能在更新要求期間修改。可能會隨著時間新增其他 `autoSync` 類型。
ErrorInfo	錯誤資訊。
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細數據。
ItemTag	表示在專案上套用的標記。
ItemType	專案的型別。可能會隨著時間新增其他項目類型。
MirroredAzureDatabricksCatalog	MirroredAzureDatabricksCatalog 專案。
MirroredAzureDatabricksCatalogProperties	MirroredAzureDatabricksCatalog 屬性。
MirroringModes	鏡像模式。可能會隨著時間新增其他 mirroringMode。
MirrorStatus	鏡像的狀態。可能會隨著時間新增其他狀態。
SqlEndpointProperties	物件，包含 SQL 端點的屬性。
Status	同步狀態。可能會隨著時間新增其他狀態。
SyncDetails	MirroredAzureDatabricksCatalog 鏡像狀態。

AutoSync

列舉型別

啟用或停用目錄的自動同步處理。啟用時，所有元數據變更，包括架構和數據表，都會每隔 15 分鐘自動同步處理一次。停用時，用戶必須手動重新整理元數據。此設定只能在更新要求期間修改。可能會隨著時間新增其他 autoSync 類型。

值	Description
Disabled	自動同步處理已停用。
Enabled	已啟用自動同步處理。

ErrorInfo

Object

錯誤資訊。

名稱	類型	Description
errorCode	string	錯誤碼。
errorDetails	string	錯誤詳細數據。
errorMessage	string	錯誤訊息。

ErrorRelatedResource

Object

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

名稱	類型	Description
resourceId	string	發生錯誤的資源識別碼。
resourceType	string	發生錯誤的資源類型。

ErrorResponse

Object

錯誤回應。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
moreDetails	ErrorResponseDetails[]	其他錯誤詳細數據的清單。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。
requestId	string	與錯誤相關聯的要求標識碼。

ErrorResponseDetails

Object

錯誤回應詳細數據。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。

ItemTag

Object

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

名稱	類型	Description
displayName	string	標籤的名稱。
id	string (uuid)	標記標識碼。

ItemType

列舉型別

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

值	Description
ApacheAirflowJob	ApacheAirflowJob。
CopyJob	複製作業。
Dashboard	PowerBI 儀錶板。
DataPipeline	數據管線。
Dataflow	數據流。
Datamart	PowerBI datamart。
DigitalTwinBuilder	DigitalTwinBuilder。
DigitalTwinBuilderFlow	數字對應項產生器流程。
Environment	環境。
Eventhouse	事件屋。
Eventstream	eventstream。
GraphQLApi	GraphQL 專案的 API。
KQLDashboard	KQL 儀錶板。
KQLDatabase	KQL 資料庫。
KQLQueryset	KQL 查詢集。
Lakehouse	湖屋
MLExperiment	機器學習實驗。
MLModel	機器學習模型。
MirroredAzureDatabricksCatalog	鏡像的 Azure databricks 目錄。
MirroredDatabase	鏡像資料庫。
MirroredWarehouse	鏡像倉儲。
MountedDataFactory	MountedDataFactory。
Notebook	筆記本。
PaginatedReport	PowerBI 編頁報表。
Reflex	反射。
Report	PowerBI 報表。
SQLDatabase	SQLDatabase。
SQLEndpoint	SQL 端點。
SemanticModel	PowerBI 語意模型。
SparkJobDefinition	Spark 作業定義。
VariableLibrary	VariableLibrary。
Warehouse	倉儲。
WarehouseSnapshot	倉儲快照集。

MirroredAzureDatabricksCatalog

Object

MirroredAzureDatabricksCatalog 專案。

名稱	類型	Description
description	string	專案描述。
displayName	string	項目顯示名稱。
folderId	string (uuid)	資料夾識別碼。
id	string (uuid)	項目標識碼。
properties	MirroredAzureDatabricksCatalogProperties	MirroredAzureDatabricksCatalog 屬性。
tags	ItemTag[]	已套用標籤的清單。
type	ItemType	項目類型。
workspaceId	string (uuid)	工作區識別碼。

MirroredAzureDatabricksCatalogProperties

Object

MirroredAzureDatabricksCatalog 屬性。

名稱	類型	Description
autoSync	AutoSync	自動同步目錄。可能會隨著時間新增其他 `autoSync` 類型。
catalogName	string	Azure databricks 目錄名稱。
databricksWorkspaceConnectionId	string (uuid)	Azure databricks 工作區聯機標識符。
mirrorStatus	MirrorStatus	MirroredAzureDatabricksCatalog 同步狀態。
mirroringMode	MirroringModes	鏡像模式。可能會隨著時間新增其他 mirroringMode。
oneLakeTablesPath	string	MirroredAzureDatabricksCatalog 數據表目錄的 OneLake 路徑。
sqlEndpointProperties	SqlEndpointProperties	物件，包含 SQL 端點的屬性。
storageConnectionId	string (uuid)	記憶體線上標識碼。
syncDetails	SyncDetails	MirroredAzureDatabricksCatalog 同步狀態。

MirroringModes

列舉型別

鏡像模式。可能會隨著時間新增其他 mirroringMode。

值	Description
Full	鏡像目錄內的所有內容，但特別排除的架構和數據表除外。如果未提供排除專案，則預設會同步所有專案。
Partial	只會鏡像選取的架構和數據表。預設不會同步任何專案。

MirrorStatus

列舉型別

鏡像的狀態。可能會隨著時間新增其他狀態。

值	Description
Mirrored	表示整個目錄已成功鏡像，確保來源中的所有架構和數據表都與 MirroredAzureDatabricksCatalog 專案完全同步。
NotMirrored	表示目錄尚未鏡像。除非明確設定，否則預設不會同步任何架構或數據表。

SqlEndpointProperties

Object

物件，包含 SQL 端點的屬性。

名稱	類型	Description
connectionString	string	SQL 端點連接字串。
id	string	SQL 端點標識碼。

Status

列舉型別

同步狀態。可能會隨著時間新增其他狀態。

值	Description
Failed	鏡像程序失敗。
InProgress	鏡像程式目前正在進行中。
NotStarted	目錄鏡像尚未啟動
Success	目錄已成功鏡像。

SyncDetails

Object

MirroredAzureDatabricksCatalog 鏡像狀態。

名稱	類型	Description
errorInfo	ErrorInfo	錯誤資訊。
lastSyncDateTime	string (date-time)	使用YYYY-MM-DDTHH：mm：ssZ格式的最後一個同步日期時間。
status	Status	同步狀態。可能會隨著時間新增其他狀態。

共用方式為

Items - Get Mirrored Azure Databricks Catalog

權限

必要的委派範圍

Microsoft Entra 支援的身份識別

介面

URI 參數

回應

範例

Get a mirroredAzureDatabricksCatalog example

範例要求

範例回覆

定義

AutoSync

ErrorInfo

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

MirroredAzureDatabricksCatalog

MirroredAzureDatabricksCatalogProperties

MirroringModes

MirrorStatus

SqlEndpointProperties

Status

SyncDetails