Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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 metastores poleceń w interfejsie wiersza polecenia usługi Databricks umożliwia zarządzanie magazynami metadanych. Magazyn metadanych to kontener obiektów najwyższego poziomu w Unity Catalog. Przechowuje on zasoby danych (tabele i widoki) oraz uprawnienia, które zarządzają dostępem do nich. Zobacz Metastore.
Przypisywanie magazynów metadanych usługi databricks
Utwórz nowe przypisanie magazynu metadanych. Jeśli przypisanie dla tego samego workspace_id istnieje, zostanie ono nadpisane przez nowe metastore_id i default_catalog_name. Dzwoniący musi być administratorem konta.
databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]
Arguments
WORKSPACE_ID
Identyfikator obszaru roboczego.
METASTORE_ID
Unikalny identyfikator magazynu metadanych.
DEFAULT_CATALOG_NAME
Deprecated. Użyj "Default Namespace API", aby skonfigurować domyślny wykaz dla obszaru roboczego usługi Databricks. Nazwa domyślnego wykazu w magazynie metadanych.
Opcje
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
Examples
Poniższy przykład przypisuje magazyn metadanych do obszaru roboczego:
databricks metastores assign 123456789 abc123-def456-ghi789 main
Tworzenie magazynów metadanych usługi databricks
Utwórz nowy magazyn metadanych na podstawie podanej nazwy i opcjonalnej ścieżki głównej magazynu. Domyślnie (jeśli pole właściciela nie jest ustawione), właścicielem nowego magazynu metadanych jest użytkownik wywołujący interfejs API createMetastore. Jeśli pole właściciela jest ustawione na pusty ciąg (""), własność zostanie przypisana do użytkownika systemowego.
databricks metastores create NAME [flags]
Arguments
NAME
Określona przez użytkownika nazwa magazynu metadanych.
Opcje
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
--region string
Region chmury, który obsługuje magazyn metadanych (np. us-west-2, westus).
--storage-root string
Główny adres URL magazynu dla magazynu metadanych.
Examples
Poniższy przykład tworzy magazyn metadanych z nazwą i katalogiem głównym:
databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2
Magazyny metadanych usługi databricks są aktualne
Pobierz przypisanie magazynu metadanych dla obszaru roboczego, do którego uzyskuje się dostęp.
databricks metastores current [flags]
Opcje
Examples
Poniższy przykład przedstawia bieżące przypisanie "metastoru":
databricks metastores current
Usuwanie magazynów metadanych Databricks
Usuń magazyn metadanych. Obiekt wywołujący musi być administratorem magazynu metadanych.
databricks metastores delete ID [flags]
Arguments
ID
Unikalny identyfikator magazynu metadanych.
Opcje
--force
Wymuś usunięcie, nawet jeśli magazyn metadanych nie jest pusty.
Examples
Poniższy przykład usuwa magazyn metadanych:
databricks metastores delete abc123-def456-ghi789
Poniższy przykład wymusza usunięcie magazynu metadanych, nawet jeśli nie jest pusty:
databricks metastores delete abc123-def456-ghi789 --force
Pobieranie magazynów metadanych usługi databricks
Pobierz magazyn metadanych zgodny z podanym identyfikatorem. Aby pobrać te informacje, obiekt wywołujący musi być administratorem magazynu metadanych.
databricks metastores get ID [flags]
Arguments
ID
Unikalny identyfikator magazynu metadanych.
Opcje
Examples
Poniższy przykład pobiera informacje o określonym magazynie metadanych:
databricks metastores get abc123-def456-ghi789
lista metastore'ów Databricks
Wypisz dostępne metastore. Dzwoniący musi być administratorem, aby pobrać te informacje. Nie ma gwarancji określonej kolejności elementów w liście.
databricks metastores list [flags]
Opcje
--max-results int
Maksymalna liczba magazynów metadanych do zwrócenia.
--page-token string
Nieprzezroczysty token stronicowania, umożliwiający przejście do następnej strony na podstawie poprzedniego zapytania.
Examples
W poniższym przykładzie wymieniono wszystkie dostępne magazyny metadanych:
databricks metastores list
W poniższym przykładzie wymieniono magazyny metadanych z podziałem na strony:
databricks metastores list --max-results 10 --page-token abc123token
Podsumowanie magazynów metadanych usługi Databricks
Uzyskaj podsumowanie informacji o magazynie metadanych. To podsumowanie zawiera poświadczenia dostępu do magazynu, dostawcę chmury, region chmury i globalny identyfikator metastore.
databricks metastores summary [flags]
Opcje
Examples
Poniższy przykład pobiera podsumowanie magazynu metadanych:
databricks metastores summary
Metamagazyny Databricks nieprzypisane
Usuń przypisanie metastore. Osoba wywołująca musi być administratorem konta.
databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]
Arguments
WORKSPACE_ID
Identyfikator obszaru roboczego.
METASTORE_ID
Zapytaj o identyfikator magazynu metadanych w celu usunięcia.
Opcje
Examples
Poniższy przykład pokazuje, jak rozdzielić metastore z obszaru roboczego.
databricks metastores unassign 123456789 abc123-def456-ghi789
Aktualizacja magazynów metadanych usługi databricks
Zaktualizuj informacje dotyczące określonego magazynu metadanych. Obiekt wywołujący musi być administratorem metastore. Jeśli pole właściciela jest ustawione na pusty ciąg (""), własność zostanie przekazana użytkownikowi systemowemu.
databricks metastores update ID [flags]
Arguments
ID
Unikalny identyfikator magazynu metadanych.
Opcje
--delta-sharing-organization-name string
Nazwa organizacji podmiotu Delta Sharing, która ma być używana w Databricks-to-Databricks Delta Sharing jako oficjalna nazwa.
--delta-sharing-recipient-token-lifetime-in-seconds int
Okres istnienia tokenu odbiorcy udostępniania Delta w sekundach.
--delta-sharing-scope DeltaSharingScopeEnum
Zakres Delta Sharing włączony dla metastore'u. Obsługiwane wartości: INTERNAL, INTERNAL_AND_EXTERNAL
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
--new-name string
Nowa nazwa magazynu metadanych.
--owner string
Właściciel magazynu metadanych.
--privilege-model-version string
Wersja modelu uprawnień magazynu metadanych, w formacie głównym.pobocznym (np. 1.0).
--storage-root-credential-id string
UUID poświadczeń przechowywania w celu uzyskania dostępu do korzenia magazynowego metadanych.
Examples
Poniższy przykład aktualizuje nazwę magazynu metadanych:
databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore
W poniższym przykładzie zaktualizowano magazyn metadanych z konfiguracją Delta Sharing.
databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org
Aktualizacja przypisania w metamagazynach Databricks
Aktualizowanie przypisania magazynu metadanych. Tej operacji można użyć do aktualizacji metastore_id lub default_catalog_name dla określonego obszaru roboczego, jeśli obszar roboczy jest już przypisany do magazynu metadanych. Osoba wywołująca musi być administratorem konta, aby móc zaktualizować metastore_id; w przeciwnym razie może być administratorem obszaru roboczego.
databricks metastores update-assignment WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
Identyfikator obszaru roboczego.
Opcje
--default-catalog-name string
Nazwa domyślnego wykazu w magazynie metadanych.
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
--metastore-id string
Unikalny identyfikator magazynu metadanych.
Examples
Poniższy przykład aktualizuje domyślny katalog przypisania metastore:
databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog
Poniższy przykład aktualizuje identyfikator magazynu metadanych przypisanego zadania:
databricks metastores update-assignment 123456789 --metastore-id new-metastore-id
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