shares 命令群組

shares 內的命令群組可讓您管理 Unity 目錄中的共用。

共享區塊是使用 shares create實例化的容器。 建立之後，您可以使用 shares update 反覆登錄在中繼存放區內定義的現有數據資產集合。 您可以在其原始名稱下註冊數據資產、依其原始架構限定，或提供替代公開的名稱。

databricks 共用建立

為數據物件建立新的共享。 創建後可以使用update加入數據物件。 呼叫端必須是中繼存放區管理員，或具有 CREATE_SHARE 中繼存放區的許可權。

databricks shares create NAME [flags]

Arguments

NAME

    股份名稱。

選項

--comment string

    使用者提供的自由格式文字描述。

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

--storage-root string

    共享中筆記本檔案的根目錄URL。

全域旗標

Examples

下列範例會建立一個名為 my-analytics-share 的共用，並附有註解：

databricks shares create my-analytics-share --comment "Sales analytics data share"

下列範例會建立具有特定記憶體根目錄的共享：

databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"

databricks 共享刪除

刪除在元數據庫中的資源共享。 呼叫者必須是共享的擁有者。

databricks shares delete NAME [flags]

Arguments

NAME

    共用的名稱。

選項

全域旗標

Examples

下列範例會刪除名為 my-analytics-share的共享：

databricks shares delete my-analytics-share

databricks 股票獲得

從元存儲庫取得共享。 呼叫端必須是中繼存放區管理員或共享的擁有者。

databricks shares get NAME [flags]

Arguments

NAME

    共用的名稱。

選項

--include-shared-data

    查詢要包含在共享中的數據。

全域旗標

Examples

下列範例會取得名為 my-analytics-share 的共用資訊：

databricks shares get my-analytics-share

下列範例會取得共享項目的詳細資訊：

databricks shares get my-analytics-share --include-shared-data

（已淘汰） Databricks 共用清單

Deprecated. 從中繼資料庫列出共享。 呼叫端必須是中繼存放區管理員或共享的擁有者。 不保證陣列中元素的順序。

databricks shares list [flags]

Arguments

None

選項

--max-results int

    傳回的股份數目上限。

--page-token string

    不透明分頁令牌會根據上一個查詢移至下一頁。

全域旗標

Databricks共用 list-shares

從中繼資料庫列出共享。 呼叫端必須是中繼存放區管理員或共享的擁有者。 不保證陣列中元素的順序。

databricks shares list-shares [flags]

Arguments

None

選項

--max-results int

    傳回的股份數目上限。

--page-token string

    不透明分頁令牌會根據上一個查詢移至下一頁。

全域旗標

Examples

以下範例列出所有共享:

databricks shares list-shares

databricks 股份更新

使用請求中的變更和資料物件更新共享項目。 呼叫端必須是共用的擁有者或中繼存放區的管理員。

當呼叫端是 Metastore 管理員時，只有 owner 欄位可以更新。

在共用名稱變更的情況下， updateShare 要求呼叫者是共用的擁有者，而且具有 CREATE_SHARE 許可權。

如果共用中有筆記本檔案， storage_root 則無法更新欄位。

對於透過此方法新增的每個數據表，共用擁有者也必須具有 SELECT 數據表的許可權。 此許可權必須無限期地維護，收件者才能存取數據表。 一般而言，您應該使用群組作為共享擁有者。

透過 update 的數據表移除不需要額外的許可權。

databricks shares update NAME [flags]

Arguments

NAME

    共用的名稱。

選項

--comment string

    使用者提供的自由格式文字描述。

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

--new-name string

    新的共用名稱。

--owner string

    目前共用擁有者的用戶名稱。

--storage-root string

    共享中筆記本檔案的根目錄URL。

全域旗標

Examples

下列範例會更新共用的批註：

databricks shares update my-analytics-share --comment "Updated sales analytics data share"

下列範例會變更共享的名稱：

databricks shares update my-analytics-share --new-name "sales-analytics-share"

下列範例會更新共享資源的擁有者：

databricks shares update my-analytics-share --owner "someone@example.com"

以下範例使用 JSON 設定來更新共用：

databricks shares update my-analytics-share --json '{
  "comment": "Updated share with new tables",
  "objects": [
    {
      "name": "sales.customers",
      "data_object_type": "TABLE"
    }
  ]
}'

databricks 分享權限設定

從中繼存放區取得數據共享的許可權。 呼叫端必須是中繼存放區管理員或共享的擁有者。

databricks shares share-permissions NAME [flags]

Arguments

NAME

    共用的名稱。

選項

--max-results int

    返回的許可權數目上限。

--page-token string

    不透明分頁令牌會根據上一個查詢移至下一頁。

全域旗標

Examples

下列範例會取得名為 my-analytics-share 的共享的權限：

databricks shares share-permissions my-analytics-share

databricks 共用更新許可權

更新中繼存放區中數據共享的許可權。 呼叫者必須是中繼存放區管理員或共享項目的擁有者。

對於新的收件者授與，使用者也必須是收件者擁有者或中繼存放區管理員。收件者撤銷不需要額外的許可權。

databricks shares update-permissions NAME [flags]

Arguments

NAME

    共用的名稱。

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

--omit-permissions-list

    Optional.

全域旗標

Examples

下列範例會將許可權授與收件者：

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "add": ["SELECT"]
    }
  ]
}'

下列範例會撤銷收件者的許可權：

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "remove": ["SELECT"]
    }
  ]
}'

全域旗標

--debug

  是否要啟用偵錯記錄。

-h 或 --help

    顯示 Databricks CLI、相關命令群組或相關命令的幫助說明。

--log-file 字串

    字串，表示要寫入輸出記錄檔的檔案。 若未指定此旗標，則預設值是將輸出記錄寫入 stderr。

--log-format 格式

    記錄格式類型，text 或 json。 預設值是 text。

--log-level 字串

    表示日誌格式層級的字串。 若未指定，則日誌的格式層級功能將被停用。

-o, --output 類型

    指令輸出類型，text 或 json。 預設值是 text。

-p, --profile 字串

    用於執行命令的~/.databrickscfg檔案中的配置檔名稱。 如果未指定此旗標，則如果存在，則會使用名為 DEFAULT 的配置檔。

--progress-format 格式

    顯示進度記錄的格式：default、、appendinplace、 或json

-t, --target 字串

    如果適用，要使用的套件組合目標