Udostępnij przez

shares grupa poleceń

Note

Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Interfejs CLI Databricks jest w publicznej wersji testowej.

Korzystanie z interfejsu wiersza polecenia usługi Databricks podlega licencjom usługi Databricks i powiadomieniom o ochronie prywatności usługi Databricks, w tym wszelkim przepisom dotyczącym danych użycia.

Grupa shares poleceń w Databricks CLI umożliwia zarządzanie udziałami w Unity Catalog.

Udział jest kontenerem instancjonowanym za pomocą shares create. Po utworzeniu można iteracyjnie zarejestrować kolekcję istniejących zasobów danych zdefiniowanych w magazynie metadanych przy użyciu polecenia shares update. Zasoby danych można zarejestrować pod oryginalną nazwą, zdefiniowaną przez oryginalny schemat, lub podać alternatywne nazwy udostępniane.

tworzenie udostępnień w Databricks

Utwórz nowy zasób dla obiektów danych. Obiekty danych można dodawać po utworzeniu za pomocą polecenia update. Obiekt wywołujący musi być administratorem magazynu metadanych lub mieć CREATE_SHARE uprawnienia do magazynu metadanych.

databricks shares create NAME [flags]

Arguments

NAME

    Nazwa udziału.

Opcje

--comment string

    Podany przez użytkownika opis w formie swobodnej.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--storage-root string

    Główny adres URL przestrzeni przechowywania dla plików notesu w udostępnionej przestrzeni.

Flagi globalne

Examples

W poniższych przykładach utworzono udział o nazwie my-analytics-share z komentarzem:

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

Poniższy przykład tworzy zasób z określonym katalogiem głównym magazynu.

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

usuwanie udziałów usługi databricks

Usuń udziały z metastore. Obiekt wywołujący musi być właścicielem udziału.

databricks shares delete NAME [flags]

Arguments

NAME

    Nazwa udziału.

Opcje

Flagi globalne

Examples

Poniższy przykład usuwa udział o nazwie my-analytics-share:

databricks shares delete my-analytics-share

pobieranie zasobów usługi databricks

Uzyskaj współdzielenie z metastore. Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem udziału.

databricks shares get NAME [flags]

Arguments

NAME

    Nazwa udziału.

Opcje

--include-shared-data

    Wykonaj zapytanie o dane, które mają być uwzględnione w udziale.

Flagi globalne

Examples

Poniższy przykład pobiera informacje o udziale o nazwie my-analytics-share:

databricks shares get my-analytics-share

Poniższy przykład uzyskuje dostęp ze szczegółowymi informacjami o udostępnionych danych.

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

(Przestarzałe) lista akcji Databricks

Deprecated. Wyświetl listę udziałów z magazynu metadanych. Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem udziału. Kolejność elementów w tablicy nie jest gwarantowana.

databricks shares list [flags]

Arguments

None

Opcje

--max-results int

    Maksymalna liczba akcji do zwrócenia.

--page-token string

    Nieprzezroczysty token stronicowania, umożliwiający przejście do następnej strony na podstawie poprzedniego zapytania.

Flagi globalne

zasoby udostępniane w Databricks list-shares

Wyświetl listę udziałów z magazynu metadanych. Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem udziału. Kolejność elementów w tablicy nie jest gwarantowana.

databricks shares list-shares [flags]

Arguments

None

Opcje

--max-results int

    Maksymalna liczba akcji do zwrócenia.

--page-token string

    Nieprzezroczysty token stronicowania, umożliwiający przejście do następnej strony na podstawie poprzedniego zapytania.

Flagi globalne

Examples

W poniższym przykładzie wymieniono wszystkie udziały:

databricks shares list-shares

aktualizacja akcji Databricks

Zaktualizuj współudostępnienie, uwzględniając zmiany i obiekty danych w żądaniu. Obiekt wywołujący musi być właścicielem udziału lub administratorem magazynu metadanych.

Gdy obiekt wywołujący jest administratorem magazynu metadanych, można zaktualizować tylko owner pole.

W przypadku zmiany nazwy udziału wymagane jest, updateShare aby obiekt wywołujący był właścicielem udziału i ma CREATE_SHARE uprawnienia.

Jeśli w udziale znajdują się pliki notesu, nie można zaktualizować pola storage_root.

Dla każdej tabeli, która jest dodawana za pomocą tej metody, właściciel udziału musi również mieć SELECT uprawnienia do tabeli. To uprawnienie musi być utrzymywane przez czas nieokreślony, aby adresaci mogli uzyskać dostęp do tabeli. Zazwyczaj należy użyć grupy jako właściciela udziału.

Usuwanie tabel za pomocą polecenia update nie wymaga dodatkowych uprawnień.

databricks shares update NAME [flags]

Arguments

NAME

    Nazwa udziału.

Opcje

--comment string

    Podany przez użytkownika opis w formie swobodnej.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--new-name string

    Nowa nazwa udziału.

--owner string

    Nazwa użytkownika bieżącego właściciela udziału.

--storage-root string

    Główny adres URL przestrzeni przechowywania dla plików notesu w udostępnionej przestrzeni.

Flagi globalne

Examples

Poniższy przykład aktualizuje komentarz udziału:

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

Poniższy przykład zmienia nazwę udziału:

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

Poniższy przykład aktualizuje właściciela udziału:

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

Poniższy przykład aktualizuje udział przy użyciu konfiguracji JSON:

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

uprawnienia dostępu w databricks

Uzyskaj uprawnienia do udostępnienia danych z magazynu metadanych. Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem udziału.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    Nazwa udziału.

Opcje

--max-results int

    Maksymalna liczba uprawnień do zwrócenia.

--page-token string

    Nieprzezroczysty token stronicowania, umożliwiający przejście do następnej strony na podstawie poprzedniego zapytania.

Flagi globalne

Examples

Poniższy przykład pobiera uprawnienia dla udziału o nazwie my-analytics-share:

databricks shares share-permissions my-analytics-share

usługa databricks aktualizuje uprawnienia dostępu

Zaktualizuj uprawnienia udziału danych w magazynie metadanych. Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem udziału.

W przypadku przyznania nowych uprawnień dla adresata, użytkownik musi być również właścicielem adresata lub administratorem magazynu metadanych. Cofanie uprawnień adresatów nie wymaga dodatkowych uprawnień.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    Nazwa udziału.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--omit-permissions-list

    Optional.

Flagi globalne

Examples

Poniższy przykład przyznaje adresatowi uprawnienia:

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

Poniższy przykład odwołuje uprawnienia dla adresata:

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

Flagi globalne

--debug

  Czy włączyć logowanie debugowe.

-h lub --help

    Wyświetl pomoc dla Databricks CLI lub dla powiązanej grupy poleceń czy pojedynczego polecenia.

--log-file struna

    Ciąg reprezentujący plik do zapisywania dzienników wyjściowych. Jeśli ta flaga nie zostanie określona, wartością domyślną jest zapisywanie dzienników wyjściowych w programie stderr.

--log-format formatowanie

    Format typu logu text lub json. Wartość domyślna to text.

--log-level struna

    Ciąg reprezentujący poziom formatu zapisu dziennika. Jeśli nie zostanie określony, poziom formatu dziennika jest wyłączony.

-o, --output typ

    Typ danych wyjściowych polecenia: text lub json. Wartość domyślna to text.

-p, --profile struna

    Nazwa profilu pliku ~/.databrickscfg, którego użyć do uruchomienia polecenia. Jeśli ta flaga nie zostanie określona, zostanie użyty profil o nazwie DEFAULT .

--progress-format formatowanie

    Format wyświetlania dzienników postępu: default, , appendinplacelubjson

-t, --target struna

    Jeśli ma to zastosowanie, docelowy obiekt pakietu do użycia

  • Last updated on