Unity 카탈로그 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 카탈로그 CLI에는 인증으로 구성된 Databricks CLI(레거시) 0.17.0 이상이 필요합니다. Databricks CLI를 업데이트하거나 설치된 버전을 나열하려면 CLI 업데이트를 참조하세요.

다음 예제의 옵션 및 필드 샘플 값은 설명용으로만 사용됩니다.

Unity 카탈로그 CLI를 사용하여 다음 작업을 수행합니다.

• 메타스토어, 스토리지 자격 증명, 외부 위치, 카탈로그, 스키마, 테이블 및 해당 권한과 같은 Unity 카탈로그 리소스입니다.
• 공유, 수신자 및 공급자와 같은 델타 공유 리소스.

Unity 카탈로그 CLI 하위 명령을 databricks unity-catalog에 추가하여 실행합니다. 이러한 하위 명령은 델타 공유 API를 포함하는 Unity 카탈로그 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 카탈로그 메타스토어 만들기도 참조하세요.

참고 항목

메타스토어를 만들어도 메타스토어가 작업 영역 또는 스토리지 자격 증명과 자동으로 연결되지는 않습니다. 이러한 작업을 완료하려면 메타스토어와 작업 영역 연결, 스토리지 자격 증명 만들기 및 메타스토어 설정 업데이트를 참조하세요.

메타스토어를 작업 영역과 연결

이미 할당된 메타스토어가 있는 작업 영역에서 이 명령을 실행하면 해당 작업 영역의 할당된 메타스토어가 업데이트됩니다.

사용 설명서를 표시하려면 databricks unity-catalog metastores assign --help를 실행합니다.

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를 실행합니다. 예를 들어 현재 메타스토어에 대한 요약 정보 가져오기를 참조하세요.

출력

{}

Unity 카탈로그 메타스토어 만들기도 참조하세요.

메타스토어 설정 업데이트

사용 설명서를 표시하려면 databricks unity-catalog metastores update --help를 실행합니다.

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:

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

스토리지 루트 자격 증명 ID를 가져오려면 스토리지 자격 증명에 대한 정보 가져오기를 참조하세요.

사용 가능한 메타스토어 나열

사용 설명서를 표시하려면 databricks unity-catalog metastores list --help를 실행합니다.

databricks unity-catalog metastores list

메타스토어에 대한 정보 가져오기

사용 설명서를 표시하려면 databricks unity-catalog metastores get --help를 실행합니다.

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

메타스토어 ID를 가져오려면 databricks unity-catalog metastores get-summary를 실행합니다. 예를 들어 현재 메타스토어에 대한 요약 정보 가져오기를 참조하세요.

현재 메타스토어에 대한 요약 정보 가져오기

사용 설명서를 표시하려면 databricks unity-catalog metastores get-summary --help를 실행합니다.

databricks unity-catalog metastores get-summary

작업 영역에 대해 현재 메타스토어 할당 가져오기

사용 설명서를 표시하려면 databricks unity-catalog metastores get-assignment --help를 실행합니다.

databricks unity-catalog metastores get-assignment

출력

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

작업 영역에서 메타스토어 연결 해제

사용 설명서를 표시하려면 databricks unity-catalog metastores unassign --help를 실행합니다.

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를 실행합니다. 예를 들어 현재 메타스토어에 대한 요약 정보 가져오기를 참조하세요.

출력

{}

메타스토어 삭제

Warning

메타스토어를 삭제하기 전에 메타스토어를 사용하는 모든 작업 영역을 삭제하거나 해당 작업 영역에 대한 메타스토어 링크를 제거해야 합니다. 작업 영역에서 메타스토어 링크를 제거하는 데 도움이 필요하면 Azure Databricks 지원 서비스에 문의하세요.

사용 설명서를 표시하려면 databricks unity-catalog metastores delete --help를 실행합니다.

메타스토어를 강제로 삭제하려면 --force 옵션을 사용합니다.

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

메타스토어 ID를 가져오려면 databricks unity-catalog metastores get-summary를 실행합니다. 예를 들어 현재 메타스토어에 대한 요약 정보 가져오기를 참조하세요.

작업이 성공하면 결과가 반환되지 않습니다.

Storage 자격 증명

unity-catalog storage-credentials 하위 명령을 사용하여 스토리지 자격 증명을 사용합니다. Azure Data Lake Storage Gen2에 연결하기 위한 스토리지 자격 증명 만들기를 참조하세요.

사용 설명서를 표시하려면 databricks unity-catalog storage-credentials --help를 실행합니다.

• 스토리지 자격 증명 만들기
• 스토리지 자격 증명 설정 업데이트
• 사용 가능한 스토리지 자격 증명 나열
• 스토리지 자격 증명에 대한 정보 가져오기
• 스토리지 자격 증명 삭제

스토리지 자격 증명 만들기

사용 설명서를 표시하려면 databricks unity-catalog storage-credentials create --help를 실행합니다.

Azure Data Lake Storage Gen2에 연결하기 위한 스토리지 자격 증명 만들기도 참조하세요.

스토리지 자격 증명 설정 업데이트

사용 설명서를 표시하려면 databricks unity-catalog storage-credentials update --help를 실행합니다.

사용 가능한 스토리지 자격 증명 나열

사용 설명서를 표시하려면 databricks unity-catalog storage-credentials list --help를 실행합니다.

databricks unity-catalog storage-credentials list

스토리지 자격 증명에 대한 정보 가져오기

사용 설명서를 표시하려면 databricks unity-catalog storage-credentials get --help를 실행합니다.

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

스토리지 자격 증명 삭제

사용 설명서를 표시하려면 databricks unity-catalog storage-credentials delete --help를 실행합니다.

스토리지 자격 증명을 강제로 삭제하려면 --force 옵션을 사용합니다.

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

작업이 성공하면 결과가 반환되지 않습니다.

외부 위치

unity-catalog external-locations 하위 명령을 사용하여 외부 위치로 작업합니다. 클라우드 스토리지를 Azure Databricks에 연결하는 외부 위치 만들기를 참조 하세요.

사용 설명서를 표시하려면 databricks unity-catalog external-locations --help를 실행합니다.

• 외부 위치 만들기
• 외부 위치 및 자격 증명 쌍의 유효성 검사
  • 외부 위치 이름 및 자격 증명 쌍을 만든 후 유효성 검사
• 외부 위치 설정 업데이트
• 사용 가능한 외부 위치 나열
• 외부 위치에 대한 정보 가져오기
• 외부 위치 삭제

외부 위치 만들기

사용 설명서를 표시하려면 databricks unity-catalog external-locations create --help를 실행합니다. 또한 클라우드 스토리지를 Azure Databricks에 연결하는 외부 위치 만들기를 참조하세요.

외부 위치 및 자격 증명 쌍의 유효성 검사

사용 설명서를 표시하려면 databricks unity-catalog external-locations validate --help를 실행합니다.

외부 위치 이름 및 자격 증명 쌍을 만든 후 유효성 검사

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

출력

{
  "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를 실행합니다.

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

udpate-external-location.json:

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

사용 가능한 외부 위치 나열

사용 설명서를 표시하려면 databricks unity-catalog external-locations list --help를 실행합니다.

databricks unity-catalog external-locations list

외부 위치에 대한 정보 가져오기

사용 설명서를 표시하려면 databricks unity-catalog external-locations get --help를 실행합니다.

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

외부 위치 삭제

사용 설명서를 표시하려면 databricks unity-catalog external-locations delete --help를 실행합니다.

외부 위치를 강제로 삭제하려면 --force 옵션을 사용합니다.

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

작업이 성공하면 결과가 반환되지 않습니다.

카탈로그

unity-catalog catalogs 하위 명령을 사용하여 카탈로그로 작업합니다.

사용 설명서를 표시하려면 databricks unity-catalog catalogs --help를 실행합니다.

• 카탈로그 만들기
• 카탈로그 설정 업데이트
• 사용 가능한 카탈로그 나열
• 카탈로그에 대한 정보 가져오기
• 카탈로그 삭제

카탈로그 만들기

사용 설명서를 표시하려면 databricks unity-catalog catalogs create --help를 실행합니다. 카탈로그 만들기도 참조하세요.

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

출력

{
  "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를 실행합니다.

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

update-catalog.json:

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

출력

{
  "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를 실행합니다.

databricks unity-catalog catalogs list

출력

{
  "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를 실행합니다.

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

출력

{
  "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 옵션을 사용합니다.

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

작업이 성공하면 결과가 반환되지 않습니다.

스키마

unity-catalog schemas 하위 명령을 사용하여 스키마로 작업합니다.

사용 설명서를 표시하려면 databricks unity-catalog schemas --help를 실행합니다.

• 스키마 만들기
• 스키마 설정 변경
• 사용 가능한 스키마 나열
• 스키마에 대한 정보 가져오기
• 스키마 삭제

스키마 만들기

사용 설명서를 표시하려면 databricks unity-catalog schemas create --help를 실행합니다. 스키마 만들기도 참조하세요.

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

출력

{
  "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를 실행합니다.

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

update-schema.json:

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

출력

{
  "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를 실행합니다.

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

출력

{
  "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를 실행합니다.

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

출력

{
  "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 옵션을 사용합니다.

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

작업이 성공하면 결과가 반환되지 않습니다.

테이블

unity-catalog tables 하위 명령을 사용하여 테이블로 작업합니다.

참고 항목

Unity 카탈로그 CLI를 사용하여 테이블 만들기는 지원되지 않습니다. 테이블을 만들려면 Unity 카탈로그 및 자습서에서 테이블 만들기: 첫 번째 테이블 만들기 및 권한 부여를 참조하세요.

사용 설명서를 표시하려면 databricks unity-catalog tables --help를 실행합니다.

• 사용 가능한 테이블 참조
• 사용 가능한 테이블의 요약 나열
• 테이블에 대한 정보 가져오기
• 테이블 삭제

사용 가능한 테이블 참조

사용 설명서를 표시하려면 databricks unity-catalog tables list --help를 실행합니다.

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

사용 가능한 테이블의 요약 나열

사용 설명서를 표시하려면 databricks unity-catalog tables list-summaries --help를 실행합니다.

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

출력

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

테이블에 대한 정보 가져오기

사용 설명서를 표시하려면 databricks unity-catalog tables get --help를 실행합니다.

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

테이블 삭제

사용 설명서를 표시하려면 databricks unity-catalog tables delete --help를 실행합니다.

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

작업이 성공하면 결과가 반환되지 않습니다.

계보

unity-catalog lineage 하위 명령을 사용하여 테이블 및 열 계보를 사용합니다.

사용 설명서를 표시하려면 databricks unity-catalog lineage --help를 실행합니다.

• 테이블의 계보 나열
• 열 계보 나열

테이블의 계보 나열

사용 설명서를 표시하려면 databricks unity-catalog lineage table --help를 실행합니다.

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

열 계보 나열

사용 설명서를 표시하려면 databricks unity-catalog lineage column --help를 실행합니다.

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 권한 및 보안 개체도 참조하세요.

카탈로그

databricks unity-catalog permissions get --catalog main

출력

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

스키마

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

출력

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

테이블

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

출력

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

스토리지 자격 증명

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

출력

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

외부 위치

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

출력

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

보안 개체의 사용 권한 업데이트

사용 설명서를 표시하려면 databricks unity-catalog permissions update --help를 실행합니다. Unity Catalog 권한 및 보안 개체도 참조하세요.

카탈로그

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

update-catalog-permissions.json:

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

스키마

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

update-schema-permissions.json:

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

테이블

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

update-table-permissions.json:

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

스토리지 자격 증명

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

update-storage-credential-permissions.json:

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

외부 위치

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

update-external-location-permissions.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 하위 명령을 사용하여 델타 공유 수신자와 그룹으로 공유하려는 델타 공유 사용 Unity 카탈로그 메타스토어의 테이블 컬렉션이 포함된 개체인 공유로 작업합니다. 공유에는 단일 메타스토어의 테이블만 포함될 수 있습니다. 델타 공유에 대한 공유 만들기 및 관리를 참조하세요.

사용 설명서를 표시하려면 databricks unity-catalog shares --help를 실행합니다.

• 공유 만들기
• 공유 설정 업데이트
  • 공유에 테이블 추가
  • 공유에서 테이블 제거
• 공유 권한 업데이트
• 사용 가능한 공유 나열
• 공유에 대한 정보 가져오기
• 공유 권한 나열
• 공유 삭제

공유 만들기

사용 설명서를 표시하려면 databricks unity-catalog shares create --help를 실행합니다. 델타 공유에 대한 공유 만들기 및 관리도 참조하세요.

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

출력

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

공유 설정 업데이트

사용 설명서를 표시하려면 databricks unity-catalog shares update --help를 실행합니다. 공유 업데이트도 참조하세요.

공유에 테이블 추가

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

출력

{
  "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"
}

공유에 테이블 추가도 참조하세요.

공유에서 테이블 제거

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

출력

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

공유에 테이블 추가도 참조하세요.

공유 권한 업데이트

사용 설명서를 표시하려면 databricks unity-catalog shares update-permissions --help를 실행합니다. 또한 델타 공유 데이터 공유에 대한 액세스 관리(공급자용)를 참조하세요.

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

update-share-permissions.json:

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

사용 가능한 공유 나열

사용 설명서를 표시하려면 databricks unity-catalog shares list --help를 실행합니다. 공유 보기 및 세부 정보 공유도 참조하세요.

databricks unity-catalog shares list

출력

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

공유에 대한 정보 가져오기

사용 설명서를 표시하려면 databricks unity-catalog shares get --help를 실행합니다. 공유 보기 및 세부 정보 공유도 참조하세요.

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

출력

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

공유 권한 나열

사용 설명서를 표시하려면 databricks unity-catalog shares list-permissions --help를 실행합니다. 공유에 대한 권한이 있는 수신자 보기도 참조하세요.

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

출력

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

공유 삭제

사용 설명서를 표시하려면 databricks unity-catalog shares delete --help를 실행합니다. 공유 삭제도 참조하세요.

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

작업이 성공하면 결과가 반환되지 않습니다.

받는 사람

unity-catalog recipients 하위 명령을 사용하여 델타 공유 사용 Unity 카탈로그 메타스토어에 대한 데이터 수신자와 함께 작업할 수 있습니다. 데이터 수신자는 Azure Databricks 사용자가 Azure Databricks 사용자 조직 외부와 데이터를 공유하는 사람 또는 그룹입니다. 델타 공유에 대한 데이터 수신자 만들기 및 관리를 참조하세요.

사용 설명서를 표시하려면 databricks unity-catalog recipients --help를 실행합니다.

• 받는 사람 만들기
• 수신자 설정 변경
• 수신자의 토큰 회전
• 사용 가능한 수신자 나열
• 수신자의 공유 권한 나열
• 수신자에 대한 정보 가져오기
• 받는 사람 삭제

수신자 만들기

사용 설명서를 표시하려면 databricks unity-catalog recipients create --help를 실행합니다. 델타 공유에 대한 데이터 수신자 만들기 및 관리도 참조하세요.

수신자에 대한 새 활성화 URL을 생성하려면 databricks unity-catalog recipients rotate-token을 실행합니다. 예를 들어 수신자의 토큰 회전을 참조하세요.

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

출력

{
  "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를 실행합니다.

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

update-recipient-settings.json:

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

출력

{
  "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를 실행합니다. 수신자 토큰 관리(공유 열기)도 참조하세요.

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

출력

{
  "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를 실행합니다. 수신자 보기도 참조하세요.

databricks unity-catalog recipients list

출력

{
  "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를 실행합니다. 수신자의 공유 권한 보기도 참조하세요.

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

출력

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

수신자에 대한 정보 가져오기

사용 설명서를 표시하려면 databricks unity-catalog recipients get --help를 실행합니다. 수신자 세부 정보 보기도 참조하세요.

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

출력

{
  "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를 실행합니다. 수신자 삭제도 참조하세요.

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

작업이 성공하면 결과가 반환되지 않습니다.

공급자

델타 공유 공유 데이터 수신자인 경우 unity-catalog providers 하위 명령을 사용하여 델타 공유 데이터 공급자와 작업합니다. 델타 공유 공급자 관리(데이터 수신자용)를 참조하세요.

사용 설명서를 표시하려면 databricks unity-catalog providers --help를 실행합니다.

• 공급자 만들기
• 공급자 설정 업데이트
• 사용 가능한 공급자 나열
• 공급자에 대한 정보 가져오기
• 공급자의 사용 가능한 공유 나열
• 공급자 삭제

공급자 만들기

열린 공유 프로토콜을 사용하여 공유되는 데이터의 수신자이고 Unity 카탈로그 메타스토어에 연결된 Databricks 작업 영역을 사용하는 경우 Unity 카탈로그 메타스토어에서 공급자 개체를 만들 수 있습니다. 그런 다음 Unity 카탈로그를 사용하여 공유 데이터에 대한 액세스를 관리할 수 있습니다.

Important

이 시나리오는 드물다. Unity 카탈로그에 사용할 수 있는 Databricks 작업 영역을 사용하고 있고 다른 Databricks 고객이 사용자와 데이터를 공유하는 경우 Databricks-to-Databricks 공유를 사용해야 합니다. Databricks-Databricks 공유를 사용하면 Unity 카탈로그에서 공급자 개체가 만들어집니다.

공급자를 만들려면 다음을 수행해야 합니다.

• 메타스토어에 대한 CREATE_PROVIDER 권한이 있는 메타스토어 관리자 또는 사용자여야 합니다.
• 다운로드한 자격 증명 파일에 액세스할 수 있습니다. 열린 공유 모델에서 액세스 가져오기를 참조하세요.

다음 명령을 실행합니다. my-provider를 공급자에 부여하려는 이름으로 바꾸고 config.share를 기본적으로 config.share라는 다운로드한 자격 증명 파일의 경로로 바꿉니다.

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

공급자 설정 업데이트

사용 설명서를 표시하려면 databricks unity-catalog providers update --help를 실행합니다.

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

사용 가능한 공급자 나열

사용 설명서를 표시하려면 databricks unity-catalog providers list --help를 실행합니다.

databricks unity-catalog providers list

공급자에 대한 정보 가져오기

사용 설명서를 표시하려면 databricks unity-catalog providers get --help를 실행합니다.

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

공급자의 사용 가능한 공유 나열

사용 설명서를 표시하려면 databricks unity-catalog providers list-shares --help를 실행합니다.

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

공급자 삭제

사용 설명서를 표시하려면 databricks unity-catalog providers delete --help를 실행합니다.

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

작업이 성공하면 결과가 반환되지 않습니다.