メインコンテンツまでスキップ

Unity Catalog CLI (レガシ)

important

このドキュメントは廃止されており、更新されない可能性があります。

この情報は、従来の Databricks CLI バージョン 0.18 以下に適用されます。 Databricks では、代わりに新しい Databricks CLI バージョン 0.205 以降を使用することをお勧めします。 「Databricks CLI とは」を参照してください。Databricks CLI のバージョンを確認するには、 databricks -vを実行します。

Databricks CLI バージョン 0.18 以前から Databricks CLI バージョン 0.205 以降に移行するには、「 Databricks CLI の移行」を参照してください。

注記

Unity Catalog CLI は 試験段階です。

Unity Catalog CLI には、Databricks CLI (レガシ) 0.17.0 以降が必要で、 認証が構成されている必要があります。 Databricks CLI を更新するか、インストールされているバージョンを一覧表示するには、「 CLI の更新」を参照してください。

次の例のオプションとフィールドのサンプル値は、説明のみを目的としています。

Unity Catalog CLI を使用して、次の操作を行います。

  • Unity Catalog メタストア、ストレージ資格情報、外部ロケーション、カタログ、スキーマ、テーブル、およびそれらのアクセス許可などのリソース。
  • Delta Sharing リソース (共有、受信者、プロバイダーなど)。

Unity Catalog CLI サブコマンドを実行するには、サブコマンドを databricks unity-catalog. これらのサブコマンドは、Delta Sharing API も含まれている Unity Catalog API を呼び出します。

使用方法のドキュメントを表示するには、 databricks unity-catalog --helpを実行します。

アウトプット：

Usage: databricks unity-catalog [OPTIONS] COMMAND [ARGS]...

  Utility to interact with Databricks Unity Catalog.

Options:
  -v, --version  0.17.1
  -h, --help     Show this message and exit.

Commands:
  catalogs
  external-locations
  lineage
  metastores
  permissions
  providers
  recipients
  schemas
  shares
  storage-credentials
  tables

メタストア​

unity-catalog metastores サブコマンドを使用して、メタストアを操作します。

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores --helpを実行します。

メタストアを作成する​

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores create --helpを実行します。 「Unity Catalogメタストアの作成」も参照してください。

Bash
databricks unity-catalog metastores create --name my-metastore \
                                           --region us-west-2 \
                                           --storage-root s3://my-bucket/abcdefghij

リージョンを指定しない場合、メタストアは現在のワークスペース リージョンに作成されます。

アウトプット：

JSON
{
  "name": "my-metastore",
  "storage_root": "s3://my-bucket/abcdefghij/12a345b6-7890-1cd2-3456-e789f0a12b34",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656112029354,
  "created_by": "someone@example.com",
  "updated_at": 1656112029354,
  "updated_by": "someone@example.com",
  "delta_sharing_enabled": false,
  "owner": "someone@example.com",
  "region": "us-west-2",
  "cloud": "aws",
  "global_metastore_id": "aws:us-west-2:12a345b6-7890-1cd2-3456-e789f0a12b34",
  "delta_sharing_scope": "INTERNAL",
  "privilege_model_version": "0.1"
}
注記

メタストアを作成しても、メタストアはワークスペースやストレージ資格情報に自動的に関連付けられません。 これらのタスクを完了するには、「 メタストアとワークスペースのリンク」、「 ストレージ資格情報の作成」、および 「メタストアの設定の更新」を参照してください。

メタストアをワークスペースにリンクする​

既にメタストアが割り当てられているワークスペースでこのコマンドを実行すると、そのワークスペースに割り当てられたメタストアが更新されます。

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores assign --helpを実行します。

Bash
databricks unity-catalog metastores assign --workspace-id 1234567890123456 \
                                           --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --default-catalog-name main

ワークスペース ID を取得するには 、「ワークスペース インスタンスの名前、URL、および ID」を参照してください。

メタストア ID を取得するには、 databricks unity-catalog metastores get-summaryを実行します。 例については、「 現在のメタストアに関する要約情報を取得する」を参照してください。

アウトプット：

JSON
{}

「Unity Catalogメタストアの作成」も参照してください。

メタストアの設定を更新する​

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores update --helpを実行します。

Bash
databricks unity-catalog metastores update --id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --json-file update-metastore.json

メタストア ID を取得するには、 databricks unity-catalog metastores get-summaryを実行します。 例については、「 現在のメタストアに関する要約情報を取得する」を参照してください。

update-metastore.json:

JSON
{
  "storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
}

ストレージ ルート資格情報 ID を取得するには、「 ストレージ資格情報に関する情報を取得する」を参照してください。

アウトプット：

JSON
{
  "name": "my-metastore",
  "storage_root": "s3://my-bucket/abcdefghij/12a345b6-7890-1cd2-3456-e789f0a12b34",
  "default_data_access_config_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656365260817,
  "created_by": "someone@example.com",
  "updated_at": 1656366434069,
  "updated_by": "someone@example.com",
  "delta_sharing_enabled": true,
  "owner": "someone@example.com",
  "delta_sharing_recipient_token_lifetime_in_seconds": 86400,
  "region": "us-west-2",
  "storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "cloud": "aws",
  "global_metastore_id": "aws:us-west-2:12a345b6-7890-1cd2-3456-e789f0a12b34",
  "delta_sharing_scope": "INTERNAL_AND_EXTERNAL",
  "privilege_model_version": "0.1"
}

使用可能なメタストアの一覧表示​

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores list --helpを実行します。

Bash
databricks unity-catalog metastores list

アウトプット：

JSON
{
  "metastores": [
    {
      "name": "my-metastore",
      "storage_root": "s3://my-bucket/abcdefghij/12a345b6-7890-1cd2-3456-e789f0a12b34",
      "default_data_access_config_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656365260817,
      "created_by": "someone@example.com",
      "updated_at": 1656366434069,
      "updated_by": "someone@example.com",
      "delta_sharing_enabled": true,
      "owner": "someone@example.com",
      "delta_sharing_recipient_token_lifetime_in_seconds": 86400,
      "region": "us-west-2",
      "storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "cloud": "aws",
      "global_metastore_id": "aws:us-west-2:12a345b6-7890-1cd2-3456-e789f0a12b34",
      "delta_sharing_scope": "INTERNAL_AND_EXTERNAL",
      "privilege_model_version": "0.1"
    },
    {
      "...": "..."
    }
  ]
}

メタストアに関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores get --helpを実行します。

Bash
databricks unity-catalog metastores get --id 12a345b6-7890-1cd2-3456-e789f0a12b34

メタストア ID を取得するには、 databricks unity-catalog metastores get-summaryを実行します。 例については、「 現在のメタストアに関する要約情報を取得する」を参照してください。

アウトプット：

JSON
{
  "name": "my-metastore",
  "storage_root": "s3://my-bucket/abcdefghij/12a345b6-7890-1cd2-3456-e789f0a12b34",
  "default_data_access_config_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656365260817,
  "created_by": "someone@example.com",
  "updated_at": 1656366434069,
  "updated_by": "someone@example.com",
  "delta_sharing_enabled": true,
  "owner": "someone@example.com",
  "delta_sharing_recipient_token_lifetime_in_seconds": 86400,
  "region": "us-west-2",
  "storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "cloud": "aws",
  "global_metastore_id": "aws:us-west-2:12a345b6-7890-1cd2-3456-e789f0a12b34",
  "delta_sharing_scope": "INTERNAL_AND_EXTERNAL",
  "privilege_model_version": "0.1"
}

現在のメタストアに関する概要情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores get-summary --helpを実行します。

Bash
databricks unity-catalog metastores get-summary

アウトプット：

JSON
{
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "name": "my-metastore",
  "default_data_access_config_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "cloud": "aws",
  "region": "us-west-2",
  "global_metastore_id": "aws:us-west-2:12a345b6-7890-1cd2-3456-e789f0a12b34",
  "storage_root_credential_name": "my-storage-root-credential"
}

ワークスペースの現在のメタストアの割り当てを取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores get-assignment --helpを実行します。

Bash
databricks unity-catalog metastores get-assignment

アウトプット：

JSON
{
  "workspace_id": 1234567890123456,
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "default_catalog_name": "main"
}

ワークスペースからのメタストアのリンク解除​

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores unassign --helpを実行します。

Bash
databricks unity-catalog metastores unassign --workspace-id 1234567890123456 \
                                             --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34

ワークスペース ID を取得するには 、「ワークスペース インスタンスの名前、URL、および ID」を参照してください。

メタストア ID を取得するには、 databricks unity-catalog metastores get-summaryを実行します。 例については、「 現在のメタストアに関する要約情報を取得する」を参照してください。

アウトプット：

JSON
{}

メタストアを削除する​

警告

メタストアを削除する前に、メタストアを使用するワークスペースを削除するか、それらのワークスペースへのメタストア リンクを削除する必要があります。 ワークスペースからメタストア リンクを削除する方法については、Databricks サポートにお問い合わせください。

使用方法のドキュメントを表示するには、 databricks unity-catalog metastores delete --helpを実行します。

メタストアを強制的に削除するには、 --force オプションを使用します。

Bash
databricks unity-catalog metastores delete --id 12a345b6-7890-1cd2-3456-e789f0a12b34

メタストア ID を取得するには、 databricks unity-catalog metastores get-summaryを実行します。 例については、「 現在のメタストアに関する要約情報を取得する」を参照してください。

操作が成功した場合、結果は返されません。

ストレージの資格情報​

unity-catalog storage-credentials サブコマンドを使用して、ストレージ資格情報を処理します。「 AWS S3 に接続するためのストレージ認証情報を作成する」を参照してください。

使用方法のドキュメントを表示するには、 databricks unity-catalog storage-credentials --helpを実行します。

ストレージの資格情報を作成する​

使用方法のドキュメントを表示するには、 databricks unity-catalog storage-credentials create --helpを実行します。

「AWS S3 に接続するためのストレージ認証情報を作成する」も参照してください。

Bash
databricks unity-catalog storage-credentials create --json-file create-storage-credential.json

create-storage-credential.json:

JSON
{
  "name": "my-storage-root-credential",
  "aws_iam_role": {
    "role_arn": "arn:aws:iam::123456789012:role/my-role"
  }
}

アウトプット：

JSON
{
  "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "name": "my-storage-root-credential",
  "aws_iam_role": {
    "role_arn": "arn:aws:iam::123456789012:role/my-role",
    "unity_catalog_iam_arn": "arn:aws:iam::414351767826:role/my-role",
    "external_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
  },
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656366379705,
  "created_by": "someone@example.com",
  "updated_at": 1656366379705,
  "updated_by": "someone@example.com",
  "used_for_managed_storage": true
}

ストレージ資格情報の設定を更新する​

使用方法のドキュメントを表示するには、 databricks unity-catalog storage-credentials update --helpを実行します。

Bash
databricks unity-catalog storage-credentials update --name my-storage-root-credential
                                                    --json-file update-storage-credential.json

update-storage-credential.json:

JSON
{
  "name": "my-storage-root-credential-2",
  "aws_iam_role": {
    "role_arn": "arn:aws:iam::123456789012:role/my-role"
  }
}

アウトプット：

JSON
{
  "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "name": "my-storage-root-credential-2",
  "aws_iam_role": {
    "role_arn": "arn:aws:iam::123456789012:role/my-role",
    "unity_catalog_iam_arn": "arn:aws:iam::414351767826:role/my-role",
    "external_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
  },
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656366379705,
  "created_by": "someone@example.com",
  "updated_at": 1656366379705,
  "updated_by": "someone@example.com",
  "used_for_managed_storage": true
}

使用可能なストレージ資格情報の一覧表示​

使用方法のドキュメントを表示するには、 databricks unity-catalog storage-credentials list --helpを実行します。

Bash
databricks unity-catalog storage-credentials list

アウトプット：

JSON
"storage_credentials": [
  {
    "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
    "name": "my-storage-root-credential",
    "aws_iam_role": {
      "role_arn": "arn:aws:iam::123456789012:role/my-role",
      "unity_catalog_iam_arn": "arn:aws:iam::123456789012:role/my-role",
      "external_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
    },
    "owner": "someone@example.com",
    "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
    "created_at": 1656366379705,
    "created_by": "someone@example.com",
    "updated_at": 1656366379705,
    "updated_by": "someone@example.com",
    "used_for_managed_storage": true
  },
  {
    "...": "..."
  }
]

ストレージ資格情報に関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog storage-credentials get --helpを実行します。

Bash
databricks unity-catalog storage-credentials get --name my-storage-root-credential

アウトプット：

JSON
{
  "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "name": "my-storage-root-credential",
  "aws_iam_role": {
    "role_arn": "arn:aws:iam::123456789012:role/my-storage-root-credential",
    "unity_catalog_iam_arn": "arn:aws:iam::414351767826:role/my-role",
    "external_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
  },
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656353829777,
  "created_by": "someone@example.com",
  "updated_at": 1656353829777,
  "updated_by": "someone@example.com"
}

ストレージ資格情報を削除する​

使用方法のドキュメントを表示するには、 databricks unity-catalog storage-credentials delete --helpを実行します。

ストレージ資格情報を強制的に削除するには、 --force オプションを使用します。

Bash
databricks unity-catalog storage-credentials delete --name my-storage-root-credential

操作が成功した場合、結果は返されません。

外部ロケーション​

unity-catalog external-locations サブコマンドを使用して、外部ロケーションを処理します。クラウドストレージをDatabricksに接続するための外部ロケーションの作成を参照してください。

使用方法のドキュメントを表示するには、 databricks unity-catalog external-locations --helpを実行します。

外部ロケーションの作成​

使用方法のドキュメントを表示するには、 databricks unity-catalog external-locations create --helpを実行します。 クラウドストレージをDatabricksに接続するための外部ロケーションの作成も参照してください。

Bash
databricks unity-catalog external-locations create --name my-external-location \
                                                   --url s3://my-bucket/abcdefghij \
                                                   --storage-credential-name my-storage-root-credential

アウトプット：

JSON
{
  "name": "my-external-location",
  "url": "s3://my-bucket/abcdefghij",
  "credential_name": "my-storage-root-credential",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656370003059,
  "created_by": "someone@example.com",
  "updated_at": 1656370003059,
  "updated_by": "someone@example.com",
  "read_only": false
}

外部ロケーションと資格情報のペアの検証​

使用方法のドキュメントを表示するには、 databricks unity-catalog external-locations validate --helpを実行します。

外部ロケーション URL と資格情報のペアを作成する前に検証します​

Bash
databricks unity-catalog external-locations validate --url s3://my-bucket/abcdefghij \
                                                     --cred-name my-storage-root-credential

アウトプット：

JSON
{
  "isDir": true,
  "results": [
    {
      "operation": "READ",
      "result": "PASS"
    },
    {
      "operation": "LIST",
      "result": "PASS"
    },
    {
      "operation": "WRITE",
      "result": "PASS"
    },
    {
      "operation": "DELETE",
      "result": "PASS"
    }
  ]
}

外部ロケーション名と資格情報のペアを作成した後に検証します​

Bash
databricks unity-catalog external-locations validate --name my-external-location \
                                                     --cred-name my-storage-root-credential

アウトプット：

JSON
{
  "isDir": true,
  "results": [
    {
      "operation": "READ",
      "result": "PASS"
    },
    {
      "operation": "LIST",
      "result": "PASS"
    },
    {
      "operation": "WRITE",
      "result": "PASS"
    },
    {
      "operation": "DELETE",
      "result": "PASS"
    }
  ]
}

外部ロケーションの設定を更新する​

使用方法のドキュメントを表示するには、 databricks unity-catalog external-locations update --helpを実行します。

Bash
databricks unity-catalog external-locations update --name my-external-location \
                                                   --json-file update-external-location.json

udpate-external-location.json:

JSON
{
  "name": "my-external-location-2"
}

アウトプット：

JSON
{
  "name": "my-external-location-2",
  "url": "s3://my-bucket/abcdefghij",
  "credential_name": "my-storage-root-credential",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656370003059,
  "created_by": "someone@example.com",
  "updated_at": 1656370379651,
  "updated_by": "someone@example.com",
  "read_only": false
}

List available 外部ロケーション​

使用方法のドキュメントを表示するには、 databricks unity-catalog external-locations list --helpを実行します。

Bash
databricks unity-catalog external-locations list

アウトプット：

JSON
{
  "external_locations": [
    {
      "name": "my-external-location",
      "url": "s3://my-bucket/abcdefghij",
      "credential_name": "my-storage-root-credential",
      "owner": "someone@example.com",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656370003059,
      "created_by": "someone@example.com",
      "updated_at": 1656370379651,
      "updated_by": "someone@example.com",
      "read_only": false
    },
    {
      "...": "..."
    }
  ]
}

外部ロケーションに関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog external-locations get --helpを実行します。

Bash
databricks unity-catalog external-locations get --name my-external-location

アウトプット：

JSON
{
  "name": "my-external-location",
  "url": "s3://my-bucket/abcdefghij",
  "credential_name": "my-storage-root-credential",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656370003059,
  "created_by": "someone@example.com",
  "updated_at": 1656370003059,
  "updated_by": "someone@example.com",
  "read_only": false
}

外部ロケーションの削除​

使用方法のドキュメントを表示するには、 databricks unity-catalog external-locations delete --helpを実行します。

外部ロケーションを強制的に削除するには、 --force オプションを使用します。

Bash
databricks unity-catalog external-locations delete --name my-external-location

操作が成功した場合、結果は返されません。

カタログ​

カタログを処理するには、unity-catalog catalogs サブコマンドを使用します。

使用方法のドキュメントを表示するには、 databricks unity-catalog catalogs --helpを実行します。

カタログを作成する​

使用方法のドキュメントを表示するには、 databricks unity-catalog catalogs create --helpを実行します。 「カタログの作成」も参照してください。

Bash
databricks unity-catalog catalogs create --name my-catalog

アウトプット：

JSON
{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

カタログの設定を更新する​

使用方法のドキュメントを表示するには、 databricks unity-catalog catalogs update --helpを実行します。

Bash
databricks unity-catalog catalogs update --name my-catalog \
                                         --json-file update-catalog.json

update-catalog.json:

JSON
{
  "name": "my-catalog-2",
  "owner": "someone@example.com"
}

アウトプット：

JSON
{
  "name": "my-catalog-2",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656355967835,
  "created_by": "someone@example.com",
  "updated_at": 1656356095989,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

利用可能なカタログを一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog catalogs list --helpを実行します。

Bash
databricks unity-catalog catalogs list

アウトプット：

JSON
{
  "catalogs": [
    {
      "name": "main",
      "owner": "someone@example.com",
      "comment": "Main catalog (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656112029355,
      "created_by": "someone@example.com",
      "updated_at": 1656112029355,
      "updated_by": "someone@example.com",
      "catalog_type": "MANAGED_CATALOG"
    },
    {
      "...": "..."
    }
  ]
}

カタログに関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog catalogs get --helpを実行します。

Bash
databricks unity-catalog catalogs get --name my-catalog

アウトプット：

JSON
{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

カタログの削除​

使用方法のドキュメントを表示するには、 databricks unity-catalog catalogs delete --helpを実行します。 「カタログの削除」も参照してください。

カタログを強制的に削除するには、 --purge オプションを使用します。

Bash
databricks unity-catalog catalogs delete --name my-catalog

操作が成功した場合、結果は返されません。

スキーマ​

unity-catalog schemas サブコマンドを使用して、スキーマを操作します。

使用方法のドキュメントを表示するには、 databricks unity-catalog schemas --helpを実行します。

スキーマを作成する​

使用方法のドキュメントを表示するには、 databricks unity-catalog schemas create --helpを実行します。 「スキーマの作成」も参照してください。

Bash
databricks unity-catalog schemas create --catalog-name my-catalog \
                                        --name my-schema

アウトプット：

JSON
{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

スキーマの設定を変更する​

使用方法のドキュメントを表示するには、 databricks unity-catalog schemas update --helpを実行します。

Bash
databricks unity-catalog schemas update --full-name my-catalog.my-schema \
                                        --json-file update-schema.json

update-schema.json:

JSON
{
  "name": "my-schema-2",
  "owner": "someone@example.com"
}

アウトプット：

JSON
{
  "name": "my-schema-2",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "comment": "Default schema (auto-created)",
  "metastore_id": "12a345b6-7890-1cd2-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"
}

使用可能なスキーマを一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog schemas list --helpを実行します。

Bash
databricks unity-catalog schemas list --catalog-name my-catalog

アウトプット：

JSON
{
  "schemas": [
    {
      "name": "default",
      "catalog_name": "my-catalog",
      "owner": "someone@example.com",
      "comment": "Default schema (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "full_name": "my-catalog.default",
      "created_at": 1656113178996,
      "created_by": "someone@example.com",
      "updated_at": 1656113178996,
      "updated_by": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

スキーマに関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog schemas get --helpを実行します。

Bash
databricks unity-catalog schemas get --full-name my-catalog.my-schema

アウトプット：

JSON
{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

スキーマの削除​

使用方法のドキュメントを表示するには、 databricks unity-catalog schemas delete --helpを実行します。 スキーマの削除も参照してください。

スキーマを強制的に削除するには、 --purge オプションを使用します。

Bash
databricks unity-catalog schemas delete --full-name my-catalog.my-schema

操作が成功した場合、結果は返されません。

テーブル​

unity-catalog tables サブコマンドを使用して、テーブルを操作します。

注記

Unity Catalog CLI を使用したテーブルの作成はサポートされていません。 テーブルを作成するには、「 テーブルとは」を参照してください。 およびチュートリアル: 最初のテーブルを作成し、権限を付与する。

使用方法のドキュメントを表示するには、 databricks unity-catalog tables --helpを実行します。

使用可能なテーブルを一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog tables list --helpを実行します。

Bash
databricks unity-catalog tables list --catalog-name main \
                                     --schema-name default

アウトプット：

JSON
{
  "tables": [
    {
      "name": "mytable",
      "catalog_name": "main",
      "schema_name": "default",
      "table_type": "MANAGED",
      "data_source_format": "DELTA",
      "columns": [
        {
          "name": "id",
          "type_text": "int",
          "type_json": "{\"name\":\"id\",\"type\":\"integer\",\"nullable\":true,\"metadata\":{}}",
          "type_name": "INT",
          "type_precision": 0,
          "type_scale": 0,
          "position": 0,
          "nullable": true
        },
        {
          "name": "name",
          "type_text": "string",
          "type_json": "{\"name\":\"name\",\"type\":\"string\",\"nullable\":true,\"metadata\":{}}",
          "type_name": "STRING",
          "type_precision": 0,
          "type_scale": 0,
          "position": 1,
          "nullable": true
        },
        {
          "name": "age",
          "type_text": "int",
          "type_json": "{\"name\":\"age\",\"type\":\"integer\",\"nullable\":true,\"metadata\":{}}",
          "type_name": "INT",
          "type_precision": 0,
          "type_scale": 0,
          "position": 2,
          "nullable": true
        }
      ],
      "storage_location": "s3://my-bucket/abcdefghij/12a345b6-7890-1cd2-3456-e789f0a12b34/tables/12a345b6-7890-1cd2-3456-e789f0a12b34",
      "owner": "someone@example.com",
      "properties": {
        "delta.lastCommitTimestamp": "1656371979000",
        "delta.lastUpdateVersion": "0",
        "delta.minWriterVersion": "2",
        "delta.minReaderVersion": "1",
        "delta.checkpoint.writeStatsAsStruct": "true",
        "delta.checkpoint.writeStatsAsJson": "false"
      },
      "metastore_id": "12a345b6-7890-1cd2-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": "12a345b6-7890-1cd2-3456-e789f0a12b34"
    },
    {
      "...": "..."
    }
  ]
}

使用可能なテーブルの概要を一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog tables list-summaries --helpを実行します。

Bash
databricks unity-catalog tables list-summaries --catalog-name main

アウトプット：

JSON
{
  "tables": [
    {
      "full_name": "main.default.mytable",
      "table_type": "MANAGED"
    },
    {
      "...": "..."
    }
  ]
}

テーブルに関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog tables get --helpを実行します。

Bash
databricks unity-catalog tables get --full-name main.default.mytable

アウトプット：

JSON
{
  "name": "mytable",
  "catalog_name": "main",
  "schema_name": "default",
  "table_type": "MANAGED",
  "data_source_format": "DELTA",
  "columns": [
    {
      "name": "id",
      "type_text": "int",
      "type_json": "{\"name\":\"id\",\"type\":\"integer\",\"nullable\":true,\"metadata\":{}}",
      "type_name": "INT",
      "type_precision": 0,
      "type_scale": 0,
      "position": 0,
      "nullable": true
    },
    {
      "name": "name",
      "type_text": "string",
      "type_json": "{\"name\":\"name\",\"type\":\"string\",\"nullable\":true,\"metadata\":{}}",
      "type_name": "STRING",
      "type_precision": 0,
      "type_scale": 0,
      "position": 1,
      "nullable": true
    },
    {
      "name": "age",
      "type_text": "int",
      "type_json": "{\"name\":\"age\",\"type\":\"integer\",\"nullable\":true,\"metadata\":{}}",
      "type_name": "INT",
      "type_precision": 0,
      "type_scale": 0,
      "position": 2,
      "nullable": true
    }
  ],
  "storage_location": "s3://my-bucket/abcdefghij/12a345b6-7890-1cd2-3456-e789f0a12b34/tables/12a345b6-7890-1cd2-3456-e789f0a12b34",
  "owner": "someone@example.com",
  "properties": {
    "delta.lastCommitTimestamp": "1656371979000",
    "delta.lastUpdateVersion": "0",
    "delta.minWriterVersion": "2",
    "delta.minReaderVersion": "1",
    "delta.checkpoint.writeStatsAsStruct": "true",
    "delta.checkpoint.writeStatsAsJson": "false"
  },
  "metastore_id": "12a345b6-7890-1cd2-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": "12a345b6-7890-1cd2-3456-e789f0a12b34"
}

テーブルの削除​

使用方法のドキュメントを表示するには、 databricks unity-catalog tables delete --helpを実行します。

Bash
databricks unity-catalog tables delete --full-name main.default.mytable

操作が成功した場合、結果は返されません。

リネージ​

unity-catalog lineage サブコマンドを使用して、テーブルと列のリネージを処理します。

使用方法のドキュメントを表示するには、 databricks unity-catalog lineage --helpを実行します。

テーブルのリネージを一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog lineage table --helpを実行します。

Bash
databricks unity-catalog lineage table --table-name main.default.mytable \
                                       --level 1

列のリネージを一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog lineage column --helpを実行します。

Bash
databricks unity-catalog lineage column --table-name main.default.mytable \
                                        --column-name id

権限​

unity-catalog permissions サブコマンドを使用して、セキュリティ保護可能なオブジェクトの権限を処理します。「Unity Catalog での特権の管理」も参照してください。

使用方法のドキュメントを表示するには、 databricks unity-catalog permissions --helpを実行します。

セキュリティ保護可能なオブジェクトの権限に関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog permissions get --helpを実行します。 「Unity Catalog の特権とセキュリティ保護可能なオブジェクト」も参照してください。

カタログ​

Bash
databricks unity-catalog permissions get --catalog main

アウトプット：

JSON
{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["USE CATALOG"]
    }
  ]
}

スキーマ​

Bash
databricks unity-catalog permissions get --schema main.default

アウトプット：

JSON
{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["USE SCHEMA"]
    }
  ]
}

テーブル​

Bash
databricks unity-catalog permissions get --table main.default.mytable

アウトプット：

JSON
{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["SELECT"]
    }
  ]
}

ストレージ資格情報​

Bash
databricks unity-catalog permissions get --storage-credential my-storage-root-credential

アウトプット：

JSON
{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["READ_FILES"]
    }
  ]
}

外部ロケーション​

Bash
databricks unity-catalog permissions get --external-location my-external-location

アウトプット：

JSON
{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["READ_FILES"]
    }
  ]
}

セキュリティ保護可能なオブジェクトの権限を更新する​

使用方法のドキュメントを表示するには、 databricks unity-catalog permissions update --helpを実行します。 「Unity Catalog の特権とセキュリティ保護可能なオブジェクト」も参照してください。

カタログ​

Bash
databricks unity-catalog permissions update --catalog \
                                            --json-file update-catalog-permissions.json

update-catalog-permissions.json:

JSON
{
  "changes": [
    {
      "principal": "account users",
      "add": ["USE CATALOG"],
      "remove": ["CREATE SCHEMA"]
    }
  ]
}

スキーマ​

Bash
databricks unity-catalog permissions update --schema \
                                            --json-file update-schema-permissions.json

update-schema-permissions.json:

JSON
{
  "changes": [
    {
      "principal": "account users",
      "add": ["USE SCHEMA"],
      "remove": ["CREATE TABLE"]
    },
    {
      "principal": "admin team",
      "add": ["CREATE TABLE"]
    }
  ]
}

テーブル​

Bash
databricks unity-catalog permissions update --table \
                                            --json-file update-table-permissions.json

update-table-permissions.json:

JSON
{
  "changes": [
    {
      "principal": "account users",
      "add": ["SELECT"],
      "remove": ["MODIFY"]
    },
    {
      "principal": "admin team",
      "add": ["ALL"]
    }
  ]
}

ストレージ資格情報​

Bash
databricks unity-catalog permissions update --storage-credential \
                                            --json-file update-storage-credential-permissions.json

update-storage-credential-permissions.json:

JSON
{
  "changes": [
    {
      "principal": "account users",
      "remove": ["READ FILES"]
    },
    {
      "principal": "storage team",
      "add": ["READ FILES", "WRITE FILES", "CREATE EXTERNAL TABLE"]
    },
    {
      "principal": "admin team",
      "add": ["ALL"]
    }
  ]
}

外部ロケーション​

Bash
databricks unity-catalog permissions update --external-location \
                                            --json-file update-external-location-permissions.json

update-external-location-permissions.json:

JSON
{
  "changes": [
    {
      "principal": "account users",
      "remove": ["READ FILES"]
    },
    {
      "principal": "storage team",
      "add": ["READ FILES", "WRITE FILES", "CREATE EXTERNAL TABLE"]
    },
    {
      "principal": "admin team",
      "add": ["ALL"]
    }
  ]
}

株式​

unity-catalog shares サブコマンドを使用して、共有 (Delta Sharing が有効な Unity Catalog メタストア内のテーブルのコレクションを含むオブジェクトで、Delta Sharing の受信者とグループとして共有するオブジェクト) を操作します。共有には、1 つのメタストアのテーブルのみを含めることができます。 「Delta Sharing の共有を作成および管理する」を参照してください。

使用方法のドキュメントを表示するには、 databricks unity-catalog shares --helpを実行します。

共有を作成する​

使用方法のドキュメントを表示するには、 databricks unity-catalog shares create --helpを実行します。 Delta Sharing の共有の作成と管理も参照してください。

Bash
databricks unity-catalog shares create --name my-share

アウトプット：

JSON
{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

共有の設定を更新する​

使用方法のドキュメントを表示するには、 databricks unity-catalog shares update --helpを実行します。 「 共有の更新」も参照してください。

共有にテーブルを追加する​

Bash
databricks unity-catalog shares update --name my-share \
                                       --add-table main.default.mytable

アウトプット：

JSON
{
  "name": "my-share",
  "objects": [
    {
      "name": "main.default.mytable",
      "data_object_type": "TABLE",
      "added_at": 1656434168847,
      "added_by": "someone@example.com",
      "shared_as": "default.mytable",
      "cdf_enabled": false
    }
  ],
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

「共有にテーブルを追加する」も参照してください。

共有からテーブルを削除する​

Bash
databricks unity-catalog shares update --name my-share \
                                       --remove-table main.default.mytable

アウトプット：

JSON
{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

「共有にテーブルを追加する」も参照してください。

共有の権限を更新する​

使用方法のドキュメントを表示するには、 databricks unity-catalog shares update-permissions --helpを実行します。 「Delta Sharing データ共有へのアクセスを管理する (プロバイダー向け)」も参照してください。

Bash
databricks unity-catalog shares update-permissions --name my-share \
                                                   --json-file update-share-permissions.json

update-share-permissions.json:

JSON
{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": ["SELECT"]
    }
  ]
}

利用可能な共有を一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog shares list --helpを実行します。 「共有の表示」および「共有の詳細」も参照してください。

Bash
databricks unity-catalog shares list

アウトプット：

JSON
{
  "shares": [
    {
      "name": "my-share",
      "created_at": 1656433327533,
      "created_by": "someone@example.com",
      "owner": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

共有に関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog shares get --helpを実行します。 「共有の表示」および「共有の詳細」も参照してください。

Bash
databricks unity-catalog shares get --name my-share

アウトプット：

JSON
{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

共有の権限を一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog shares list-permissions --helpを実行します。 「共有に対するアクセス許可を持つ受信者を表示する」も参照してください。

Bash
databricks unity-catalog shares list-permissions --name my-share

アウトプット：

JSON
{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": ["SELECT"]
    }
  ]
}

共有を削除する​

使用方法のドキュメントを表示するには、 databricks unity-catalog shares delete --helpを実行します。 「共有の削除」も参照してください。

Bash
databricks unity-catalog shares delete --name my-share

操作が成功した場合、結果は返されません。

受信者​

unity-catalog recipients サブコマンドを使用して、Delta Sharing が有効な Unity Catalog メタストアのデータ受信者を操作します。データ受信者は、Databricks ユーザーが Databricks ユーザーの組織外でデータを共有するユーザーまたはグループです。「Delta Sharing (Databricks-to-Databricks共有) のデータ受信者の作成と管理」を参照してください。

使用方法のドキュメントを表示するには、 databricks unity-catalog recipients --helpを実行します。

受信者を作成する​

使用方法のドキュメントを表示するには、 databricks unity-catalog recipients create --helpを実行します。Delta Sharingのデータ受信者を作成および管理する (Databricks-to-Databricks 共有) も参照してください。

受信者の新しいアクティベーション URL を生成するには、 databricks unity-catalog recipients rotate-tokenを実行します。 例については、「 受信者のトークンをローテーションする」を参照してください。

Bash
databricks unity-catalog recipients create --name my-recipient

アウトプット：

JSON
{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

受信者の設定を変更する​

使用方法のドキュメントを表示するには、 databricks unity-catalog recipients update --helpを実行します。

Bash
databricks unity-catalog recipients update --name my-recipient \
                                           --json-file update-recipient-settings.json

update-recipient-settings.json:

JSON
{
  "name": "my-recipient-2"
}

アウトプット：

JSON
{
  "name": "my-recipient-2",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656436740986,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

受信者のトークンをローテーションする​

使用方法のドキュメントを表示するには、 databricks unity-catalog recipients rotate-token --helpを実行します。「受信者トークンの管理」も参照してください。

Bash
databricks unity-catalog recipients rotate-token --name my-recipient \
                                                 --existing-token-expire-in-seconds 900

アウトプット：

JSON
{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

利用可能な受信者を一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog recipients list --helpを実行します。 「受信者の表示」も参照してください。

Bash
databricks unity-catalog recipients list

アウトプット：

JSON
{
  "recipients": [
    {
      "name": "my-recipient",
      "created_at": 1656435288003,
      "created_by": "someone@example.com",
      "tokens": [
        {
          "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
          "created_at": 1656435288005,
          "created_by": "someone@example.com",
          "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
          "expiration_time": 1656521688006,
          "updated_at": 1656435288006,
          "updated_by": "someone@example.com"
        }
      ],
      "authentication_type": "TOKEN",
      "updated_at": 1656435288003,
      "updated_by": "someone@example.com",
      "owner": "someone@example.com"
    }
  ]
}

受信者の共有権限を一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog recipients list-permissions --helpを実行します。 「受信者の共有権限を表示する」も参照してください。

Bash
databricks unity-catalog recipients list-permissions --name my-recipient

アウトプット：

JSON
{
  "permissions_out": [
    {
      "share_name": "my-share",
      "privilege_assignments": [
        {
          "privileges": ["SELECT"]
        }
      ]
    }
  ]
}

受信者に関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog recipients get --helpを実行します。 「受信者の詳細の表示」も参照してください。

Bash
databricks unity-catalog recipients get --name my-recipient

アウトプット：

JSON
{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

受信者を削除する​

使用方法のドキュメントを表示するには、 databricks unity-catalog recipients delete --helpを実行します。 「受信者の削除」も参照してください。

Bash
databricks unity-catalog recipients delete --name my-recipient

操作が成功した場合、結果は返されません。

プロバイダー​

Delta Sharing 共有データ受信者の場合は、 unity-catalog providers サブコマンドを使用して Delta Sharing データ・プロバイダーを操作します。 「Delta Sharing プロバイダーの管理 (データ受信者向け)」を参照してください。

使用方法のドキュメントを表示するには、 databricks unity-catalog providers --helpを実行します。

プロバイダーを作成する​

オープン共有プロトコルを使用して共有されるデータの受信者であり、Unity Catalog メタストアにアタッチされている Databricks ワークスペースを使用している場合は、Unity Catalog メタストアにプロバイダー オブジェクトを作成できます。その後、Unity Catalog を使用して共有データへのアクセスを管理できます。

important

このシナリオはまれです。 が有効になっているDatabricks ワークスペースを使用していて、別のUnity Catalog Databricks顧客がデータを共有している場合は、Databricks-to-Databricks 共有 を使用する必要があります。Databricks-to-Databricks共有では、プロバイダー オブジェクトが Unity Catalogで作成されます。

プロバイダーを作成するには、次の操作を行う必要があります。

次のコマンドを実行し、 my-provider をプロバイダーに付ける名前に置き換え、 config.share ダウンロードした資格情報ファイル (デフォルトでは config.share という名前) へのパスに置き換えます。

Bash
databricks unity-catalog providers create --name my-provider  \
                  --recipient-profile-json-file config.share

プロバイダーの設定を更新する​

使用方法のドキュメントを表示するには、 databricks unity-catalog providers update --helpを実行します。

Bash
databricks unity-catalog providers update --name my-provider \
                                          --new-name my-provider-2

利用可能なプロバイダーを一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog providers list --helpを実行します。

Bash
databricks unity-catalog providers list

プロバイダーに関する情報を取得する​

使用方法のドキュメントを表示するには、 databricks unity-catalog providers get --helpを実行します。

Bash
databricks unity-catalog providers get --name my-provider

プロバイダーの利用可能な共有を一覧表示する​

使用方法のドキュメントを表示するには、 databricks unity-catalog providers list-shares --helpを実行します。

Bash
databricks unity-catalog providers list-shares --name my-provider

プロバイダーを削除する​

使用方法のドキュメントを表示するには、 databricks unity-catalog providers delete --helpを実行します。

Bash
databricks unity-catalog providers delete --name my-provider

操作が成功した場合、結果は返されません。

に最終更新