다음을 통해 공유

shares 명령 그룹

Note

이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.

Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.

shares Databricks CLI 내의 명령 그룹을 사용하면 Unity 카탈로그에서 공유를 관리할 수 있습니다.

공유는 shares create으로 인스턴스화된 컨테이너입니다. 만든 후에는 을 사용하여 shares update메타스토어 내에 정의된 기존 데이터 자산의 컬렉션을 반복적으로 등록할 수 있습니다. 원래 이름으로 데이터 자산을 등록하거나, 원래 스키마로 정규화하거나, 대체 노출 이름을 제공할 수 있습니다.

Databricks에서 공유 생성하기

데이터 개체에 대한 새 공유를 만듭니다. update로 데이터 객체를 생성한 후 추가할 수 있습니다. 호출자는 metastore 관리자이거나 CREATE_SHARE metastore에 대한 권한이 있어야 합니다.

databricks shares create NAME [flags]

Arguments

NAME

    공유 이름

Options

--comment string

    사용자가 제공한 자유 형식 텍스트 설명입니다.

--json JSON

    요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--storage-root string

    공유의 Notebook 파일에 대한 스토리지 루트 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

    공유의 이름입니다.

Options

전역 플래그

Examples

다음 예제에서는 이름이 지정된 my-analytics-share공유를 삭제합니다.

databricks shares delete my-analytics-share

databricks 공유 가져오기

메타스토어에서 공유를 가져옵니다. 호출자는 metastore 관리자 또는 공유 소유자여야 합니다.

databricks shares get NAME [flags]

Arguments

NAME

    공유의 이름입니다.

Options

--include-shared-data

    공유에 포함할 데이터를 쿼리합니다.

전역 플래그

Examples

다음 예제에서는 명명 my-analytics-share된 공유에 대한 정보를 가져옵니다.

databricks shares get my-analytics-share

다음 예제에서는 공유된 데이터의 세부 정보가 포함된 공유를 받습니다.

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

(사용되지 않음) databricks 공유 목록

Deprecated. 메타스토어의 공유를 나열합니다. 호출자는 metastore 관리자 또는 공유 소유자여야 합니다. 배열의 요소 순서는 보장되지 않습니다.

databricks shares list [flags]

Arguments

None

Options

--max-results int

    반환할 최대 공유 수입니다.

--page-token string

    이전 쿼리를 기반으로 다음 페이지로 이동하기 위한 불투명 페이지네이션 토큰입니다.

전역 플래그

databricks 공유 목록 표시

메타스토어의 공유를 나열합니다. 호출자는 metastore 관리자 또는 공유 소유자여야 합니다. 배열의 요소 순서는 보장되지 않습니다.

databricks shares list-shares [flags]

Arguments

None

Options

--max-results int

    반환할 최대 공유 수입니다.

--page-token string

    이전 쿼리를 기반으로 다음 페이지로 이동하기 위한 불투명 페이지네이션 토큰입니다.

전역 플래그

Examples

다음 예제에서는 모든 공유를 나열합니다.

databricks shares list-shares

databricks 주식 업데이트

요청의 변경 내용 및 데이터 개체로 공유를 업데이트합니다. 호출자는 공유 또는 메타스토어 관리자의 소유자여야 합니다.

호출자가 metastore 관리자인 경우 필드만 owner 업데이트할 수 있습니다.

공유 이름이 변경 updateShare 되는 경우 호출자가 공유의 소유자이며 CREATE_SHARE 권한이 있어야 합니다.

공유에 Notebook 파일이 있는 경우 필드를 storage_root 업데이트할 수 없습니다.

이 메서드를 통해 추가되는 각 테이블에 대해 공유 소유자에게는 테이블에 대한 권한도 SELECT 있어야 합니다. 받는 사람이 테이블에 액세스할 수 있도록 이 권한은 무기한 유지 관리해야 합니다. 일반적으로 그룹을 공유 소유자로 사용해야 합니다.

update을 통해 테이블을 제거하는 것은 추가 권한이 필요하지 않습니다.

databricks shares update NAME [flags]

Arguments

NAME

    공유의 이름입니다.

Options

--comment string

    사용자가 제공한 자유 형식 텍스트 설명입니다.

--json JSON

    요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--new-name string

    공유 이름의 변경.

--owner string

    현재 공유 소유자의 사용자 이름입니다.

--storage-root string

    공유의 Notebook 파일에 대한 스토리지 루트 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 공유 설정 권한

메타스토어에서 데이터 공유에 대한 권한을 가져옵니다. 호출자는 metastore 관리자 또는 공유 소유자여야 합니다.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    공유의 이름입니다.

Options

--max-results int

    반환할 최대 사용 권한 수입니다.

--page-token string

    이전 쿼리를 기반으로 다음 페이지로 이동하기 위한 불투명 페이지네이션 토큰입니다.

전역 플래그

Examples

다음 예제에서는 명명 my-analytics-share된 공유에 대한 권한을 가져옵니다.

databricks shares share-permissions my-analytics-share

databricks는 update-permissions를 공유합니다.

메타스토어에서 데이터 공유에 대한 권한을 업데이트합니다. 호출자는 metastore 관리자 또는 공유 소유자여야 합니다.

새 받는 사람 부여의 경우 사용자는 받는 사람 소유자 또는 metastore 관리자여야 합니다. 받는 사람 해지 시 추가 권한이 필요하지 않습니다.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    공유의 이름입니다.

Options

--json JSON

    요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--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, append, inplace또는 json

-t, --target 문자열

    해당하는 경우 사용할 번들 대상

  • Last updated on