共用方式為

稽核和監視資料共用

  • 發行項

本文說明數據提供者和收件者如何使用稽核記錄來監視 Delta Sharing 事件。 提供者稽核記錄提供者所採取的動作，以及提供者共享數據上收件者所採取的動作。 收件者稽核記錄與存取共用和管理提供者對象相關的事件。

若要檢視清單 Delta Sharing 稽核記錄事件，請參閱 Delta Sharing 事件。

需求

若要存取稽核記錄，帳戶管理員必須為您的 Azure Databricks 帳戶啟用稽核記錄系統數據表。 請參閱 啟用系統數據表。 如需稽核記錄系統數據表的資訊，請參閱 稽核記錄系統數據表參考。

如果您不是帳戶管理員或中繼存放區管理員，則必須獲得讀取稽核記錄的 system.access.audit 存取權。

在稽核記錄中檢視差異共用事件

如果您的帳戶已啟用系統數據表，稽核記錄會儲存在 中 system.access.audit。 或者，如果您的帳戶具有 稽核記錄傳遞設定，您必須知道傳送記錄的貯體和路徑。

記錄的事件

若要檢視 Delta Sharing 稽核記錄事件的清單，請參閱 Delta Sharing 事件。

檢視收件者查詢結果的詳細數據

在提供者記錄中，傳回為 deltaSharingQueriedTableChanges 和 deltaSharingQueriedTable 的事件會在數據收件者的查詢取得響應之後記錄。 提供者可以檢視 response.result 這些記錄的欄位，以查看與收件者共用之內容的詳細數據。 欄位可以包含下列值。 此清單並不完整。

"checkpointBytes": "0",
"earlyTermination": "false",
"maxRemoveFiles": "0",
"path": "file: example/s3/path/golden/snapshot-data0/_delta_log",
"deltaSharingPartitionFilteringAccessed": "false",
"deltaSharingRecipientId": "<redacted>",
"deltaSharingRecipientIdHash": "<recipient-hash-id>",
"jsonLogFileNum": "1",
"scannedJsonLogActionNum": "5",
"numRecords": "3",
"deltaSharingRecipientMetastoreId": "<redacted>",
"userAgent": "Delta-Sharing-Unity-Catalog-Databricks-Auth/1.0 Linux/4.15.0-2068-azure-fips OpenJDK_64-Bit_Server_VM/11.0.7+10-jvmci-20.1-b02 java/11.0.7 scala/2.12.15 java_vendor/GraalVM_Community",
"jsonLogFileBytes": "2846",
"checkpointFileNum": "0",
"metastoreId": "<redacted>",
"limitHint": "Some(1)",
"tableName": "cookie_ingredients",
"tableId": "1234567c-6d8b-45fd-9565-32e9fc23f8f3",
"activeAddFiles": "2", // number of AddFiles returned in the query
"numAddFiles": "2", // number of AddFiles returned in the query
"numAddCDCFiles": "2", // number of AddFiles returned in the CDF query
"numRemoveFiles": "2", // number of RemoveFiles returned in the query
"numSeenAddFiles": "3",
"scannedAddFileSize": "1300", // file size in bytes for the AddFile returned in the query
"scannedAddCDCFileSize": "1300", // file size in bytes for the AddCDCFile returned in the CDF query
"scannedRemoveFileSize": "1300", // file size in bytes for the RemoveFile returned in the query
"scannedCheckpointActionNum": "0",
"tableVersion": "0"

記錄的錯誤

如果嘗試的 Delta Sharing 動作失敗，則會記錄動作，並在記錄的欄位中顯示錯誤訊息 response.error_message 。 和 > 字元之間的<專案代表佔位元文字。

提供者記錄中的錯誤訊息

差異共享會記錄資料提供者的下列錯誤：

  • 選取的中繼存放區中未啟用差異共用。

    DatabricksServiceException: FEATURE_DISABLED:
Delta Sharing is not enabled

  • 在不存在的目錄上嘗試作業。

    DatabricksServiceException: CATALOG_DOES_NOT_EXIST:
Catalog ‘<catalog>’ does not exist.

  • 並非帳戶管理員或中繼存放區管理員的使用者嘗試執行特殊權限作業。

    DatabricksServiceException: PERMISSION_DENIED:
Only administrators can <operation-name> <operation-target>

  • 嘗試從未指派中繼存放區的工作區對中繼存放區進行作業。

    DatabricksServiceException: INVALID_STATE:
Workspace <workspace-name> is no longer assigned to this metastore

  • 要求遺漏收件者名稱或共用名稱。

    DatabricksServiceException: INVALID_PARAMETER_VALUE: CreateRecipient/CreateShare Missing required field: <recipient-name>/<share-name>

  • 要求包含無效的收件者名稱或共用名稱。

    DatabricksServiceException: INVALID_PARAMETER_VALUE: CreateRecipient/CreateShare <recipient-name>/<share-name> is not a valid name

  • 使用者嘗試共用不在 Unity 目錄中繼存放區的資料表。

    DatabricksServiceException: INVALID_PARAMETER_VALUE: Only managed or external table on Unity Catalog can be added to a share

  • 使用者嘗試輪替已經處於輪替狀態且先前的權杖尚未過期的收件者。

    DatabricksServiceException: INVALID_PARAMETER_VALUE: There are already two active tokens for recipient <recipient-name>

  • 使用者嘗試建立新的收件者，或共用與現有收件者相同的名稱。

    DatabricksServiceException: RECIPIENT_ALREADY_EXISTS/SHARE_ALREADY_EXISTS: Recipient/Share <name> already exists`

  • 使用者嘗試對不存在的收件者或共用執行作業。

    DatabricksServiceException: RECIPIENT_DOES_NOT_EXIST/SHARE_DOES_NOT_EXIST: Recipient/Share '<name>' does not exist

  • 使用者嘗試將資料表新增至共用，但已新增資料表。

    DatabricksServiceException: RESOURCE_ALREADY_EXISTS: Shared Table '<name>' already exists

  • 使用者嘗試執行參考不存在的資料表的作業。

    DatabricksServiceException: TABLE_DOES_NOT_EXIST: Table '<name>' does not exist

  • 使用者嘗試執行參考不存在的結構描述的作業。

    DatabricksServiceException: SCHEMA_DOES_NOT_EXIST: Schema '<name>' does not exist

  • 使用者嘗試存取不存在的共用。

    DatabricksServiceException: SHARE_DOES_NOT_EXIST: Share <share-name> does not exist.

收件者記錄中的錯誤訊息

差異共享會記錄資料收件者的下列錯誤：

  • 使用者嘗試存取沒有存取權限的共用。

    DatabricksServiceException: PERMISSION_DENIED:
User does not have SELECT on Share <share-name>

  • 使用者嘗試存取不存在的共用。

    DatabricksServiceException: SHARE_DOES_NOT_EXIST: Share <share-name> does not exist.

  • 使用者嘗試存取不存在於共用中的資料表。

    DatabricksServiceException: TABLE_DOES_NOT_EXIST: <table-name> does not exist.