Unity Catalog命令行

請注意

Unity Catalog CLI是實驗．

Unity Catalog CLI要求磚CLI0.17.0或以上版本，配置身份驗證．更新Databricks命令行或列出已安裝的版本，請參見更新命令行．

以下示例中的選項和字段示例值僅用於說明目的。

使用Unity Catalog CLI工作:

統一目錄資源，如亞存儲、存儲憑證、外部位置、目錄、模式、表及其權限。
三角洲分享共享、收件人和提供者等資源。

運行Unity Catalog CLI子命令的方法是將它們附加到磚unity-catalog．

要顯示使用文檔，請運行磚unity-catalog——幫助．

輸出:

            用法:databricks unit -catalog [OPTIONS] COMMAND [ARGS]…實用程序與Databricks統一目錄交互。選項:-v，——version 0.17.1 -h，——help顯示此消息並退出。命令:catalogs external-locations沿襲metastores權限提供者收件人schema共享存儲憑證表
           

Metastores

使用unity-catalogmetastores使用的子命令metastores．

要顯示使用文檔，請運行磚unity-catalogmetastores——幫助．

產生亞轉移

要顯示使用文檔，請運行磚unity-catalogmetastores創建——幫助．另請參閱創建一個Unity Catalog metastore．

              數據庫統一目錄亞metastore創建-name my-metastore＼——地區us-west-2＼——貯藏根s3: / /桶/ abcdefghij
             

如果您沒有指定區域，則會在當前工作區區域中創建metastore。

輸出:

              ｛“名稱”：“my-metastore”，“storage_root”：“s3: / /桶/ abcdefghij / 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656112029354，“created_by”：“someone@example.com”，“updated_at”：1656112029354，“updated_by”：“someone@example.com”，“delta_sharing_enabled”：假，“所有者”：“someone@example.com”，“地區”：“us-west-2”，“雲”：“aws”，“global_metastore_id”：“aws:美國-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”，“delta_sharing_scope”：“內部”，“privilege_model_version”：“0.1”｝
             

請注意

創建metastore不會自動將metastore與工作區或存儲憑據關聯起來。要完成這些任務，請參見將metastore與工作區連接起來，創建存儲憑證,更新一個metastore的設置．

將metastore與工作區連接起來

如果您在一個已經有一個已分配的metastore的工作空間上運行這個命令，您將更新該工作空間的已分配的metastore。

要顯示使用文檔，請運行磚unity-catalogmetastores分配——幫助．

              Databricks單位目錄亞metastores分配——workspace-id1234567890123456＼——metastore-id 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34＼——default-catalog-name主要
             

要獲取工作區ID，請參見工作區實例名、url和id．

要獲取亞metastore ID，請運行磚unity-catalogmetastores得到概要．有關示例，請參見獲取當前亞轉移的概要信息．

輸出:

{}

另請參閱創建一個Unity Catalog metastore而且(可選)將metastore鏈接到其他工作空間．

更新一個metastore的設置

要顯示使用文檔，請運行磚unity-catalogmetastores更新——幫助．

              Databricks單位目錄亞肉瘤更新——id 12a345b6-7890-1cd2-3456-e789f0a12b34＼——json文件update-metastore.json
             

要獲取亞metastore ID，請運行磚unity-catalogmetastores得到概要．有關示例，請參見獲取當前亞轉移的概要信息．

update-metastore.json：

              ｛“storage_root_credential_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”｝
             

要獲取存儲根憑據ID，請參見獲取關於存儲憑據的信息．

輸出:

              ｛“名稱”：“my-metastore”，“storage_root”：“s3: / /桶/ abcdefghij / 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“default_data_access_config_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656365260817，“created_by”：“someone@example.com”，“updated_at”：1656366434069，“updated_by”：“someone@example.com”，“delta_sharing_enabled”：真正的，“所有者”：“someone@example.com”，“delta_sharing_recipient_token_lifetime_in_seconds”：86400，“地區”：“us-west-2”，“storage_root_credential_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“雲”：“aws”，“global_metastore_id”：“aws:美國-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”，“delta_sharing_scope”：“INTERNAL_AND_EXTERNAL”，“privilege_model_version”：“0.1”｝
             

列出可用的亞轉移

要顯示使用文檔，請運行磚unity-catalogmetastores列表——幫助．

Databricks單位目錄亞metastores列表

輸出:

              ｛“metastores”：［｛“名稱”：“my-metastore”，“storage_root”：“s3: / /桶/ abcdefghij / 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“default_data_access_config_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656365260817，“created_by”：“someone@example.com”，“updated_at”：1656366434069，“updated_by”：“someone@example.com”，“delta_sharing_enabled”：真正的，“所有者”：“someone@example.com”，“delta_sharing_recipient_token_lifetime_in_seconds”：86400，“地區”：“us-west-2”，“storage_root_credential_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“雲”：“aws”，“global_metastore_id”：“aws:美國-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”，“delta_sharing_scope”：“INTERNAL_AND_EXTERNAL”，“privilege_model_version”：“0.1”}，｛“…”：“…”｝］｝
             

獲取有關亞轉移的信息

要顯示使用文檔，請運行磚unity-catalogmetastores得到——幫助．

              Databricks unit -catalog metastores get——id 12a345b6-7890-1cd2-3456-e789f0a12b34
             

要獲取亞metastore ID，請運行磚unity-catalogmetastores得到概要．有關示例，請參見獲取當前亞轉移的概要信息．

輸出:

              ｛“名稱”：“my-metastore”，“storage_root”：“s3: / /桶/ abcdefghij / 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“default_data_access_config_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656365260817，“created_by”：“someone@example.com”，“updated_at”：1656366434069，“updated_by”：“someone@example.com”，“delta_sharing_enabled”：真正的，“所有者”：“someone@example.com”，“delta_sharing_recipient_token_lifetime_in_seconds”：86400，“地區”：“us-west-2”，“storage_root_credential_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“雲”：“aws”，“global_metastore_id”：“aws:美國-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”，“delta_sharing_scope”：“INTERNAL_AND_EXTERNAL”，“privilege_model_version”：“0.1”｝
             

獲取當前亞轉移的概要信息

要顯示使用文檔，請運行磚unity-catalogmetastores得到概要——幫助．

Databricks單位目錄亞metastores get-summary

輸出:

              ｛“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“名稱”：“my-metastore”，“default_data_access_config_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“storage_root_credential_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“雲”：“aws”，“地區”：“us-west-2”，“global_metastore_id”：“aws:美國-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”，“storage_root_credential_name”：“my-storage-root-credential”｝
             

獲取工作空間的當前metastore分配

要顯示使用文檔，請運行磚unity-catalogmetastores來分派任務——幫助．

數據庫單位目錄亞存儲獲取分配

輸出:

              ｛“workspace_id”：1234567890123456，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“default_catalog_name”：“主要”｝
             

從工作空間中斷開一個metastore

要顯示使用文檔，請運行磚unity-catalogmetastoresunassign——幫助．

              數據庫單元目錄亞存儲unassign -workspace-id1234567890123456＼——metastore-id 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34
             

要獲取工作區ID，請參見工作區實例名、url和id．

要獲取亞metastore ID，請運行磚unity-catalogmetastores得到概要．有關示例，請參見獲取當前亞轉移的概要信息．

輸出:

{}

刪除一個metastore

警告

在刪除metastore之前，必須刪除使用該metastore的任何工作空間，或者刪除到這些工作空間的metastore鏈接。聯係Databricks支持，以幫助從工作區中刪除metastore鏈接。

要顯示使用文檔，請運行磚unity-catalogmetastores刪除——幫助．

若要強製刪除亞metastore，請使用——力選擇。

              Databricks unit -catalog metastores delete——id 12a345b6-7890-1cd2-3456-e789f0a12b34
             

要獲取亞metastore ID，請運行磚unity-catalogmetastores得到概要．有關示例，請參見獲取當前亞轉移的概要信息．

如果操作成功，則無返回結果。

存儲憑證

使用unity-catalogstorage-credentials使用的子命令存儲憑證．

要顯示使用文檔，請運行磚unity-catalogstorage-credentials——幫助．

創建存儲憑證

要顯示使用文檔，請運行磚unity-catalogstorage-credentials創建——幫助．

另請參閱創建存儲憑證．

創建——json-file create- storage-credentials .json

create-storage-credential.json：

              ｛“名稱”：“my-storage-root-credential”，“aws_iam_role”：｛“role_arn”：“攻擊:aws:我::123456789012:角色/我的角色”｝｝
             

輸出:

              ｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“名稱”：“my-storage-root-credential”，“aws_iam_role”：｛“role_arn”：“攻擊:aws:我::123456789012:角色/我的角色”，“unity_catalog_iam_arn”：“攻擊:aws:我::414351767826:角色/我的角色”，“external_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”}，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656366379705，“created_by”：“someone@example.com”，“updated_at”：1656366379705，“updated_by”：“someone@example.com”，“used_for_managed_storage”：真正的｝
             

更新存儲憑證的設置

要顯示使用文檔，請運行磚unity-catalogstorage-credentials更新——幫助．另請參閱重命名存儲憑證．

              數據庫單元-目錄存儲-憑證更新——name my-storage-root-credential——json-file update-storage-credential.json
             

update-storage-credential.json：

              ｛“名稱”：“my-storage-root-credential-2”，“aws_iam_role”：｛“role_arn”：“攻擊:aws:我::123456789012:角色/我的角色”｝｝
             

輸出:

              ｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“名稱”：“my-storage-root-credential-2”，“aws_iam_role”：｛“role_arn”：“攻擊:aws:我::123456789012:角色/我的角色”，“unity_catalog_iam_arn”：“攻擊:aws:我::414351767826:角色/我的角色”，“external_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”}，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656366379705，“created_by”：“someone@example.com”，“updated_at”：1656366379705，“updated_by”：“someone@example.com”，“used_for_managed_storage”：真正的｝
             

列出可用的存儲憑證

要顯示使用文檔，請運行磚unity-catalogstorage-credentials列表——幫助．另請參閱列出存儲憑據．

Databricks單元目錄存儲憑證列表

輸出:

              “storage_credentials”：［｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“名稱”：“my-storage-root-credential”，“aws_iam_role”：｛“role_arn”：“攻擊:aws:我::123456789012:角色/我的角色”，“unity_catalog_iam_arn”：“攻擊:aws:我::123456789012:角色/我的角色”，“external_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”}，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656366379705，“created_by”：“someone@example.com”，“updated_at”：1656366379705，“updated_by”：“someone@example.com”，“used_for_managed_storage”：真正的}，｛“…”：“…”｝］
             

獲取關於存儲憑據的信息

要顯示使用文檔，請運行磚unity-catalogstorage-credentials得到——幫助．另請參閱查看存儲證書．

數據庫單元目錄存儲憑證get——name my-storage-root-credential

輸出:

              ｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“名稱”：“my-storage-root-credential”，“aws_iam_role”：｛“role_arn”：“攻擊:aws:我::123456789012:角色/ my-storage-root-credential”，“unity_catalog_iam_arn”：“攻擊:aws:我::414351767826:角色/我的角色”，“external_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”}，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656353829777，“created_by”：“someone@example.com”，“updated_at”：1656353829777，“updated_by”：“someone@example.com”｝
             

刪除存儲證書

要顯示使用文檔，請運行磚unity-catalogstorage-credentials刪除——幫助．另請參閱刪除存儲證書．

若要強製刪除存儲憑據，請使用——力選擇。

刪除——name my-storage-root-credential

如果操作成功，則無返回結果。

外部位置

使用unity-catalogexternal-locations使用的子命令外部位置．

要顯示使用文檔，請運行磚unity-catalogexternal-locations——幫助．

創建外部位置

要顯示使用文檔，請運行磚unity-catalogexternal-locations創建——幫助．另請參閱創建外部位置．

              數據庫unit -catalog external-locations create——name my-external-location＼——url s3: / /桶/ abcdefghij＼——storage-credential-name my-storage-root-credential
             

輸出:

              ｛“名稱”：“my-external-location”，“url”：“s3: / /桶/ abcdefghij”，“credential_name”：“my-storage-root-credential”，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“credential_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656370003059，“created_by”：“someone@example.com”，“updated_at”：1656370003059，“updated_by”：“someone@example.com”，“read_only”：假｝
             

驗證外部位置和憑據對

要顯示使用文檔，請運行磚unity-catalogexternal-locations驗證——幫助．

在創建外部位置URL和憑據對之前驗證它們

               Databricks unit -catalog external-locations validate——url s3://my-bucket/abcdefghij＼——cred-name my-storage-root-credential
              

輸出:

               ｛“isDir”：真正的，“結果”：［｛“操作”：“讀”，“結果”：“通過”}，｛“操作”：“列表”，“結果”：“通過”}，｛“操作”：“寫”，“結果”：“通過”}，｛“操作”：“刪除”，“結果”：“通過”｝］｝
              

在創建外部位置名稱和憑據對之後驗證它們

               數據庫單元目錄external-locations validate——name my-external-location＼——cred-name my-storage-root-credential
              

輸出:

               ｛“isDir”：真正的，“結果”：［｛“操作”：“讀”，“結果”：“通過”}，｛“操作”：“列表”，“結果”：“通過”}，｛“操作”：“寫”，“結果”：“通過”}，｛“操作”：“刪除”，“結果”：“通過”｝］｝
              

更新外部位置的設置

要顯示使用文檔，請運行磚unity-catalogexternal-locations更新——幫助．另請參閱修改外部位置．

              數據庫unit -catalog external-locations update——name my-external-location＼——json文件update-external-location.json
             

udpate-external-location.json：

              ｛“名稱”：“my-external-location-2”｝
             

輸出:

              ｛“名稱”：“my-external-location-2”，“url”：“s3: / /桶/ abcdefghij”，“credential_name”：“my-storage-root-credential”，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“credential_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656370003059，“created_by”：“someone@example.com”，“updated_at”：1656370379651，“updated_by”：“someone@example.com”，“read_only”：假｝
             

列出可用的外部位置

要顯示使用文檔，請運行磚unity-catalogexternal-locations列表——幫助．

Databricks單元目錄外部位置列表

輸出:

              ｛“external_locations”：［｛“名稱”：“my-external-location”，“url”：“s3: / /桶/ abcdefghij”，“credential_name”：“my-storage-root-credential”，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“credential_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656370003059，“created_by”：“someone@example.com”，“updated_at”：1656370379651，“updated_by”：“someone@example.com”，“read_only”：假}，｛“…”：“…”｝］｝
             

獲取有關外部位置的信息

要顯示使用文檔，請運行磚unity-catalogexternal-locations得到——幫助．另請參閱描述一個外部位置．

數據庫unit -catalog external-locations get——name my-external-location

輸出:

              ｛“名稱”：“my-external-location”，“url”：“s3: / /桶/ abcdefghij”，“credential_name”：“my-storage-root-credential”，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“credential_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656370003059，“created_by”：“someone@example.com”，“updated_at”：1656370003059，“updated_by”：“someone@example.com”，“read_only”：假｝
             

刪除外部位置

要顯示使用文檔，請運行磚unity-catalogexternal-locations刪除——幫助．另請參閱刪除外部位置．

若要強製刪除外部位置，請使用——力選擇。

刪除——name my-external-location

如果操作成功，則無返回結果。

              ｛“名稱”：“我的目錄”，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656113178995，“created_by”：“someone@example.com”，“updated_at”：1656113178995，“updated_by”：“someone@example.com”，“catalog_type”：“MANAGED_CATALOG”｝
             

更新目錄的設置

要顯示使用文檔，請運行磚unity-catalog目錄更新——幫助．

              Databricks unit -catalog目錄更新——命名my-catalog＼——json文件update-catalog.json
             

update-catalog.json：

              ｛“名稱”：“my-catalog-2”，“所有者”：“someone@example.com”｝
             

輸出:

              ｛“名稱”：“my-catalog-2”，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656355967835，“created_by”：“someone@example.com”，“updated_at”：1656356095989，“updated_by”：“someone@example.com”，“catalog_type”：“MANAGED_CATALOG”｝
             

列出可用目錄

要顯示使用文檔，請運行磚unity-catalog目錄列表——幫助．

Databricks統一目錄目錄列表

輸出:

              ｛“目錄”：［｛“名稱”：“主要”，“所有者”：“someone@example.com”，“評論”：“主目錄(自動創建)”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656112029355，“created_by”：“someone@example.com”，“updated_at”：1656112029355，“updated_by”：“someone@example.com”，“catalog_type”：“MANAGED_CATALOG”}，｛“…”：“…”｝］｝
             

獲取關於目錄的信息

要顯示使用文檔，請運行磚unity-catalog目錄得到——幫助．

Databricks unit -catalog目錄得到——命名我的目錄

輸出:

              ｛“名稱”：“我的目錄”，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656113178995，“created_by”：“someone@example.com”，“updated_at”：1656113178995，“updated_by”：“someone@example.com”，“catalog_type”：“MANAGED_CATALOG”｝
             

刪除目錄

要顯示使用文檔，請運行磚unity-catalog目錄刪除——幫助．另請參閱刪除目錄．

要強製刪除目錄，請使用——清除選擇。

Databricks unit -catalog目錄刪除——命名my-catalog

如果操作成功，則無返回結果。

模式

使用unity-catalog模式使用的子命令模式．

要顯示使用文檔，請運行磚unity-catalog模式——幫助．

創建一個模式

要顯示使用文檔，請運行磚unity-catalog模式創建——幫助．另請參閱創建一個模式．

              數據庫單元目錄模式創建——catalog-name my-catalog＼——名字我模式
             

輸出:

              ｛“名稱”：“我模式”，“catalog_name”：“我的目錄”，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“full_name”：“my-catalog.my-schema”，“created_at”：1656113607800，“created_by”：“someone@example.com”，“updated_at”：1656113607800，“updated_by”：“someone@example.com”｝
             

更改模式的設置

要顯示使用文檔，請運行磚unity-catalog模式更新——幫助．

              數據庫單元目錄模式更新——全稱my-catalog.my-schema＼——json文件update-schema.json
             

update-schema.json：

              ｛“名稱”：“my-schema-2”，“所有者”：“someone@example.com”｝
             

輸出:

              ｛“名稱”：“my-schema-2”，“catalog_name”：“我的目錄”，“所有者”：“someone@example.com”，“評論”：默認模式(自動創建)，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“full_name”：“my-catalog.my-schema-2”，“created_at”：1656355967837，“created_by”：“someone@example.com”，“updated_at”：1656356592786，“updated_by”：“someone@example.com”｝
             

列出可用的模式

要顯示使用文檔，請運行磚unity-catalog模式列表——幫助．

數據庫單元目錄模式列表——catalog-name my-catalog

輸出:

              ｛“模式”：［｛“名稱”：“默認”，“catalog_name”：“我的目錄”，“所有者”：“someone@example.com”，“評論”：默認模式(自動創建)，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“full_name”：“my-catalog.default”，“created_at”：1656113178996，“created_by”：“someone@example.com”，“updated_at”：1656113178996，“updated_by”：“someone@example.com”}，｛“…”：“…”｝］｝
             

獲取關於模式的信息

要顯示使用文檔，請運行磚unity-catalog模式得到——幫助．

數據庫單元目錄模式獲取——全稱my-catalog.my-schema

輸出:

              ｛“名稱”：“我模式”，“catalog_name”：“我的目錄”，“所有者”：“someone@example.com”，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“full_name”：“my-catalog.my-schema”，“created_at”：1656113607800，“created_by”：“someone@example.com”，“updated_at”：1656113607800，“updated_by”：“someone@example.com”｝
             

刪除模式

要顯示使用文檔，請運行磚unity-catalog模式刪除——幫助．另請參閱刪除模式．

要強製刪除模式，請使用——清除選擇。

Databricks unit -catalog schema delete——全稱my-catalog.my-schema

如果操作成功，則無返回結果。

表

使用unity-catalog表使用的子命令表．

請注意

不支持使用Unity Catalog CLI創建表。要創建表，請參見創建表而且創建第一個表．

要顯示使用文檔，請運行磚unity-catalog表——幫助．

列出可用的表

要顯示使用文檔，請運行磚unity-catalog表列表——幫助．

              Databricks單元目錄表列表——catalog-name main＼——默認模式名稱
             

輸出:

              ｛“表”：［｛“名稱”：“mytable”，“catalog_name”：“主要”，“schema_name”：“默認”，“table_type”：“管理”，“data_source_format”：“δ”，“列”：［｛“名稱”：“id”，“type_text”：“int”，“type_json”：“{\“\”:\“id \”,\“\”,\“整數\”,\“nullable \”:真的,\ \“元數據”:{}}”，“type_name”：“INT”，“type_precision”：0，“type_scale”：0，“位置”：0，“可以為空”：真正的}，｛“名稱”：“名稱”，“type_text”：“字符串”，“type_json”：“{\“\”:\“\”,\“\”,\“\”,\“nullable \”:真的,\ \“元數據”:{}}”，“type_name”：“字符串”，“type_precision”：0，“type_scale”：0，“位置”：1，“可以為空”：真正的}，｛“名稱”：“年齡”，“type_text”：“int”，“type_json”：“{\“\”:\“年齡\”,\“\”,\“整數\”,\“nullable \”:真的,\ \“元數據”:{}}”，“type_name”：“INT”，“type_precision”：0，“type_scale”：0，“位置”：2，“可以為空”：真正的｝),“storage_location”：“s3: / /桶/ abcdefghij / 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34 /表/ 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“所有者”：“someone@example.com”，“屬性”：｛“delta.lastCommitTimestamp”：“1656371979000”，“delta.lastUpdateVersion”：“0”，“delta.minWriterVersion”：“2”，“delta.minReaderVersion”：“1”，“delta.checkpoint.writeStatsAsStruct”：“真正的”，“delta.checkpoint.writeStatsAsJson”：“假”}，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“full_name”：“main.default.mytable”，“data_access_configuration_id”：“00000000-0000-0000-0000-000000000000”，“created_at”：1656371992807，“created_by”：“someone@example.com”，“updated_at”：1656371992807，“updated_by”：“someone@example.com”，“table_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”}，｛“…”：“…”｝］｝
             

列出可用表的摘要

要顯示使用文檔，請運行磚unity-catalog表list-summaries——幫助．

數據庫單元目錄表列表摘要——catalog-name main

輸出:

              ｛“表”：［｛“full_name”：“main.default.mytable”，“table_type”：“管理”}，｛“…”：“…”｝］｝
             

獲取關於表的信息

要顯示使用文檔，請運行磚unity-catalog表得到——幫助．

Databricks單元目錄表獲取——全名main.default.mytable

輸出:

              ｛“名稱”：“mytable”，“catalog_name”：“主要”，“schema_name”：“默認”，“table_type”：“管理”，“data_source_format”：“δ”，“列”：［｛“名稱”：“id”，“type_text”：“int”，“type_json”：“{\“\”:\“id \”,\“\”,\“整數\”,\“nullable \”:真的,\ \“元數據”:{}}”，“type_name”：“INT”，“type_precision”：0，“type_scale”：0，“位置”：0，“可以為空”：真正的}，｛“名稱”：“名稱”，“type_text”：“字符串”，“type_json”：“{\“\”:\“\”,\“\”,\“\”,\“nullable \”:真的,\ \“元數據”:{}}”，“type_name”：“字符串”，“type_precision”：0，“type_scale”：0，“位置”：1，“可以為空”：真正的}，｛“名稱”：“年齡”，“type_text”：“int”，“type_json”：“{\“\”:\“年齡\”,\“\”,\“整數\”,\“nullable \”:真的,\ \“元數據”:{}}”，“type_name”：“INT”，“type_precision”：0，“type_scale”：0，“位置”：2，“可以為空”：真正的｝),“storage_location”：“s3: / /桶/ abcdefghij / 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34 /表/ 12 a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“所有者”：“someone@example.com”，“屬性”：｛“delta.lastCommitTimestamp”：“1656371979000”，“delta.lastUpdateVersion”：“0”，“delta.minWriterVersion”：“2”，“delta.minReaderVersion”：“1”，“delta.checkpoint.writeStatsAsStruct”：“真正的”，“delta.checkpoint.writeStatsAsJson”：“假”}，“metastore_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“full_name”：“main.default.mytable”，“data_access_configuration_id”：“00000000-0000-0000-0000-000000000000”，“created_at”：1656371992807，“created_by”：“someone@example.com”，“updated_at”：1656371992807，“updated_by”：“someone@example.com”，“table_id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”｝
             

刪除表

要顯示使用文檔，請運行磚unity-catalog表刪除——幫助．

數據庫單元目錄表刪除——全名main.default.mytable

如果操作成功，則無返回結果。

血統

使用unity-catalog血統子命令來處理表和列的譜係。

要顯示使用文檔，請運行磚unity-catalog血統——幫助．

列出表的譜係

要顯示使用文檔，請運行磚unity-catalog血統表格——幫助．

              數據庫單元目錄沿襲表——table-name main.default.mytable＼——水平1
             

列出列的沿襲

要顯示使用文檔，請運行磚unity-catalog血統列——幫助．

              數據庫單元目錄沿襲列——table-name main.default.mytable＼——列名id
             

權限

使用unity-catalog權限子命令使用的權限可獲得的對象．另請參閱在Unity目錄中管理權限．

要顯示使用文檔，請運行磚unity-catalog權限——幫助．

獲取有關可安全對象的權限的信息

要顯示使用文檔，請運行磚unity-catalog權限得到——幫助．另請參閱Unity Catalog特權和安全對象．

模式

數據庫單元目錄權限獲取——schema main.default

輸出:

               ｛“privilege_assignments”：［｛“校長”：“用戶帳戶”，“特權”：［“使用模式”］｝］｝
              

表格

數據庫單元目錄權限獲取——table main.default.mytable

輸出:

               ｛“privilege_assignments”：［｛“校長”：“用戶帳戶”，“特權”：［“選擇”］｝］｝
              

存儲憑證

               數據庫單元目錄權限獲取——storage-credential my-storage-root-credential
              

輸出:

               ｛“privilege_assignments”：［｛“校長”：“用戶帳戶”，“特權”：［“read_file”］｝］｝
              

外部位置

數據庫單元目錄權限get——external-location my-external-location

輸出:

               ｛“privilege_assignments”：［｛“校長”：“用戶帳戶”，“特權”：［“read_file”］｝］｝
              

更新安全對象的權限

要顯示使用文檔，請運行磚unity-catalog權限更新——幫助．另請參閱Unity Catalog特權和安全對象．

模式

               Databricks單元目錄權限更新——schema＼——json文件update-schema-permissions.json
              

update-schema-permissions.json：

               ｛“改變”：［｛“校長”：“用戶帳戶”，“添加”：［“使用模式”),“刪除”：［“CREATE TABLE”］}，｛“校長”：“管理團隊”，“添加”：［“CREATE TABLE”］｝］｝
              

表格

               Databricks單元目錄權限更新——table＼——json文件update-table-permissions.json
              

update-table-permissions.json：

               ｛“改變”：［｛“校長”：“用戶帳戶”，“添加”：［“選擇”),“刪除”：［“修改”］}，｛“校長”：“管理團隊”，“添加”：［“所有”］｝］｝
              

存儲憑證

               數據庫單元目錄權限更新——storage-credential＼——json文件update-storage-credential-permissions.json
              

update-storage-credential-permissions.json：

               ｛“改變”：［｛“校長”：“用戶帳戶”，“刪除”：［“讀文件”］}，｛“校長”：“存儲團隊”，“添加”：［“讀文件”，“寫文件”，“創建外部表”］}，｛“校長”：“管理團隊”，“添加”：［“所有”］｝］｝
              

外部位置

               數據庫單元目錄權限更新——external-location＼——json文件update-external-location-permissions.json
              

update-external-location-permissions.json：

               ｛“改變”：［｛“校長”：“用戶帳戶”，“刪除”：［“讀文件”］}，｛“校長”：“存儲團隊”，“添加”：［“讀文件”，“寫文件”，“創建外部表”］}，｛“校長”：“管理團隊”，“添加”：［“所有”］｝］｝
              

股票

使用unity-catalog股票子命令來使用共享，共享是在支持Delta Sharing的Unity Catalog metastore中包含表集合的對象，您希望將其作為一個組與Delta Sharing接收方共享。一個共享隻能包含來自單個metastore的表。看到為Delta Sharing創建和管理共享．

要顯示使用文檔，請運行磚unity-catalog股票——幫助．

更新共享設置

要顯示使用文檔，請運行磚unity-catalog股票更新——幫助．另請參閱更新股票．

更新共享權限

要顯示使用文檔，請運行磚unity-catalog股票update-permissions——幫助．另請參閱授予和管理對Delta Sharing數據共享的訪問權．

              數據庫單元目錄共享更新權限——命名my-share＼——json文件update-share-permissions.json
             

update-share-permissions.json：

              ｛“privilege_assignments”：［｛“校長”：“my-recipient”，“特權”：［“選擇”］｝］｝
             

列出可用股份

要顯示使用文檔，請運行磚unity-catalog股票列表——幫助．另請參閱查看共享和共享詳細信息．

Databricks單元目錄共享列表

輸出:

              ｛“股票”：［｛“名稱”：“我”，“created_at”：1656433327533，“created_by”：“someone@example.com”，“所有者”：“someone@example.com”}，｛“…”：“…”｝］｝
             

列出共享的權限

要顯示使用文檔，請運行磚unity-catalog股票list-permissions——幫助．另請參閱查看共享的權限接收人．

數據庫單元-目錄共享列表-權限——命名my-share

輸出:

              ｛“privilege_assignments”：［｛“校長”：“my-recipient”，“特權”：［“選擇”］｝］｝
             

收件人

使用unity-catalog收件人子命令與數據接收者一起工作，為Delta共享啟用了Unity Catalog亞metastores。數據接收者是Databricks用戶與Databricks用戶組織之外的人或組共享數據。看到為增量共享創建和管理數據接收方．

要顯示使用文檔，請運行磚unity-catalog收件人——幫助．

創建收件人

要顯示使用文檔，請運行磚unity-catalog收件人創建——幫助．另請參閱為增量共享創建和管理數據接收方．

要為收件人生成一個新的激活URL，請運行磚unity-catalog收件人rotate-token．有關示例，請參見旋轉接收者的令牌．

數據庫單元目錄收件人創建——name my-收件人

輸出:

              ｛“名稱”：“my-recipient”，“created_at”：1656435288003，“created_by”：“someone@example.com”，“令牌”：［｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656435288005，“created_by”：“someone@example.com”，“activation_url”：“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”，“expiration_time”：1656521688006，“updated_at”：1656435288006，“updated_by”：“someone@example.com”｝),“authentication_type”：“令牌”，“updated_at”：1656435288003，“updated_by”：“someone@example.com”，“所有者”：“someone@example.com”｝
             

更改收件人的設置

要顯示使用文檔，請運行磚unity-catalog收件人更新——幫助．

              Databricks unit -catalog收件人更新——name my-收件人＼——json文件update-recipient-settings.json
             

update-recipient-settings.json：

              ｛“名稱”：“my-recipient-2”｝
             

輸出:

              ｛“名稱”：“my-recipient-2”，“created_at”：1656435288003，“created_by”：“someone@example.com”，“令牌”：［｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656435288005，“created_by”：“someone@example.com”，“expiration_time”：1656436808507，“updated_at”：1656435908507，“updated_by”：“someone@example.com”}，｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656435908509，“created_by”：“someone@example.com”，“activation_url”：“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”，“expiration_time”：1656522308510，“updated_at”：1656435908510，“updated_by”：“someone@example.com”｝),“authentication_type”：“令牌”，“updated_at”：1656436740986，“updated_by”：“someone@example.com”，“所有者”：“someone@example.com”｝
             

旋轉接收者的令牌

要顯示使用文檔，請運行磚unity-catalog收件人rotate-token——幫助．另請參閱管理接收方令牌(開放共享)．

              Databricks unit -catalog收件人rotate-token——name my-收件人＼——existing-token-expire-in-seconds900
             

輸出:

              ｛“名稱”：“my-recipient”，“created_at”：1656435288003，“created_by”：“someone@example.com”，“令牌”：［｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656435288005，“created_by”：“someone@example.com”，“expiration_time”：1656436808507，“updated_at”：1656435908507，“updated_by”：“someone@example.com”}，｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656435908509，“created_by”：“someone@example.com”，“activation_url”：“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”，“expiration_time”：1656522308510，“updated_at”：1656435908510，“updated_by”：“someone@example.com”｝),“authentication_type”：“令牌”，“updated_at”：1656435288003，“updated_by”：“someone@example.com”，“所有者”：“someone@example.com”｝
             

列出可用的收件人

要顯示使用文檔，請運行磚unity-catalog收件人列表——幫助．另請參閱查看收件人．

Databricks單元目錄收件人列表

輸出:

              ｛“收件人”：［｛“名稱”：“my-recipient”，“created_at”：1656435288003，“created_by”：“someone@example.com”，“令牌”：［｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656435288005，“created_by”：“someone@example.com”，“activation_url”：“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”，“expiration_time”：1656521688006，“updated_at”：1656435288006，“updated_by”：“someone@example.com”｝),“authentication_type”：“令牌”，“updated_at”：1656435288003，“updated_by”：“someone@example.com”，“所有者”：“someone@example.com”｝］｝
             

獲取收件人的信息

要顯示使用文檔，請運行磚unity-catalog收件人得到——幫助．另請參閱查看收件人詳細信息．

Databricks unit -catalog收件人get——name my-收件人

輸出:

              ｛“名稱”：“my-recipient”，“created_at”：1656435288003，“created_by”：“someone@example.com”，“令牌”：［｛“id”：“十二a345b6張cd - 7890 - 1 - 3456 e789f0a12b34”，“created_at”：1656435288005，“created_by”：“someone@example.com”，“activation_url”：“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”，“expiration_time”：1656521688006，“updated_at”：1656435288006，“updated_by”：“someone@example.com”｝),“authentication_type”：“令牌”，“updated_at”：1656435288003，“updated_by”：“someone@example.com”，“所有者”：“someone@example.com”｝
             

刪除收件人

要顯示使用文檔，請運行磚unity-catalog收件人刪除——幫助．另請參閱刪除收件人．

Databricks unit -catalog收件人delete——name my-收件人

如果操作成功，則無返回結果。

供應商

如果您是Delta共享共享數據接收方，請使用unity-catalog供應商子命令使用Delta共享數據提供程序。看到管理增量共享提供程序(用於數據接收方)．

要顯示使用文檔，請運行磚unity-catalog供應商——幫助．

創建提供者

的共享數據的接收者開放共享協議並且你正在使用一個Databricks工作空間，它附加到一個Unity Catalog metastore，你可以在你的Unity Catalog metastore中創建一個provider對象。然後，您可以使用Unity Catalog管理對共享數據的訪問。

另請參閱Databricks:使用Unity Catalog讀取共享數據

要創建一個提供者，你必須:

屬性的metastore管理員或用戶CREATE_PROVIDER亞轉移的特權。
訪問下載的憑據文件。看到在開放共享模型中獲得訪問權．

執行以下命令，替換我的供應者使用您想要提供給提供者的名稱和config.share使用下載的憑據文件的路徑，該文件名為config。默認為共享。

              數據庫單元目錄提供者創建——name my-provider＼——recipient-profile-json-file config.share
             

更新提供者的設置

要顯示使用文檔，請運行磚unity-catalog供應商更新——幫助．

              數據庫單元目錄提供者更新——name my-provider＼——新名字my-provider-2
             

列出可用的提供程序

要顯示使用文檔，請運行磚unity-catalog供應商列表——幫助．

Databricks單元目錄提供者列表

獲取有關提供者的信息

要顯示使用文檔，請運行磚unity-catalog供應商得到——幫助．

Databricks單元目錄提供者獲取——name my-provider

列出提供者的可用共享

要顯示使用文檔，請運行磚unity-catalog供應商上市——幫助．

數據庫單元-目錄提供者列表-共享——命名我的提供者

刪除提供程序

要顯示使用文檔，請運行磚unity-catalog供應商刪除——幫助．

Databricks unit -catalog providers delete——name my-provider

如果操作成功，則無返回結果。