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 poleceń storage-credentials w Databricks CLI zawiera polecenia do zarządzania poświadczeniami magazynu w Unity Catalog. Poświadczenie przechowywania danych stanowi mechanizm uwierzytelniania i autoryzacji umożliwiający dostęp do danych przechowywanych w środowisku chmurowym użytkownika. Każde poświadczenie magazynu podlega zasadom kontroli dostępu Unity Catalog, które określają, którzy użytkownicy i grupy mogą uzyskiwać do niego dostęp. Jeśli użytkownik nie ma dostępu do poświadczeń magazynu w Unity Catalog, żądanie zakończy się niepowodzeniem, a Unity Catalog nie podejmie próby uwierzytelnienia w środowisku chmury w imieniu użytkownika. Zobacz Zarządzanie poświadczeniami magazynowymi.
utwórz poświadczenia magazynu Databricks
Utwórz nowe poświadczenia magazynu.
Obiekt wywołujący musi być administratorem magazynu metadanych lub mieć CREATE_STORAGE_CREDENTIAL uprawnienia do magazynu metadanych.
databricks storage-credentials create NAME [flags]
Arguments
NAME
Nazwa poświadczeń. Nazwa musi być unikatowa wśród poświadczeń magazynowania i usługi w ramach metastore'u.
Opcje
--comment string
Komentarz skojarzony z poświadczeniem.
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
--read-only
Określa, czy poświadczenie może być używane tylko w przypadku operacji odczytu.
--skip-validation
Podanie wartości true dla tego argumentu powoduje pominięcie weryfikacji utworzonego poświadczenia.
Examples
Poniższy przykład tworzy nowe poświadczenie magazynowe.
databricks storage-credentials create my-storage-credential
Poniższy przykład tworzy poświadczenie magazynowe wraz z komentarzem:
databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"
Poniższy przykład tworzy poświadczenie magazynu tylko do odczytu.
databricks storage-credentials create my-storage-credential --read-only
usuń poświadczenia magazynu databricks
Usuń poświadczenia magazynu z magazynu metadanych. Obiekt wywołujący musi być właścicielem poświadczeń magazynu.
databricks storage-credentials delete NAME [flags]
Arguments
NAME
Nazwa poświadczenia magazynu.
Opcje
--force
Wymuś aktualizację, nawet jeśli istnieją zależne lokalizacje zewnętrzne lub tabele zewnętrzne (gdy cel to STORAGE) lub usługi zależne (gdy cel ma wartość SERVICE).
Examples
Poniższy przykład usuwa poświadczenia magazynu:
databricks storage-credentials delete my-storage-credential
Poniższy przykład wymusza usunięcie poświadczeń magazynu:
databricks storage-credentials delete my-storage-credential --force
pobieranie poświadczeń magazynu usługi databricks
Pobierz poświadczenie dostępu z magazynu metadanych. Obiekt wywołujący musi być administratorem magazynu metadanych, właścicielem poświadczeń magazynu lub mieć jakieś uprawnienia do poświadczeń magazynu.
databricks storage-credentials get NAME [flags]
Arguments
NAME
Nazwa poświadczenia magazynu.
Opcje
Examples
Poniższy przykład pobiera informacje o poświadczeniu magazynu:
databricks storage-credentials get my-storage-credential
lista poświadczeń storage dla Databricks
Wymień poświadczenia magazynu. Lista jest ograniczona tylko do tych poświadczeń magazynu, do których obiekt wywołujący ma uprawnienia dostępu. Jeśli obiekt wywołujący jest administratorem magazynu metadanych, pobieranie poświadczeń jest nieograniczone. Nie ma gwarancji, że istnieje określona kolejność elementów w tablicy.
databricks storage-credentials list [flags]
Opcje
--max-results int
Maksymalna liczba poświadczeń magazynu 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 poświadczenia magazynu:
databricks storage-credentials list
aktualizacja poświadczeń magazynowania Databricks
Zaktualizuj poświadczenie magazynu w magazynie metadanych.
Obiekt wywołujący musi być właścicielem poświadczeń magazynu lub administratorem magazynu metadanych. Jeśli obiekt wywołujący jest administratorem magazynu metadanych, można zmienić tylko owner pole.
databricks storage-credentials update NAME [flags]
Arguments
NAME
Nazwa poświadczenia magazynu.
Opcje
--comment string
Komentarz skojarzony z poświadczeniem.
--force
Wymuś aktualizację, nawet jeśli istnieją zależne lokalizacje zewnętrzne lub tabele zewnętrzne.
--isolation-mode IsolationMode
Czy element zabezpieczalny jest dostępny ze wszystkich obszarów roboczych czy tylko z określonej grupy obszarów roboczych? Obsługiwane wartości: [ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN]
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
--new-name string
Nowa nazwa poświadczenia danych.
--owner string
Nazwa użytkownika bieżącego właściciela poświadczeń.
--read-only
Określa, czy poświadczenie może być używane tylko w przypadku operacji odczytu.
--skip-validation
Podanie wartości true dla tego argumentu powoduje pominięcie weryfikacji zaktualizowanego poświadczenia.
Examples
Przykład poniżej aktualizuje komentarz dotyczący poświadczeń magazynowych.
databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"
Poniższy przykład zmienia właściciela poświadczenia dostępu do magazynu.
databricks storage-credentials update my-storage-credential --owner someone@example.com
W poniższym przykładzie zmieniono nazwę poświadczenia magazynu:
databricks storage-credentials update my-storage-credential --new-name updated-credential
walidacja poświadczeń magazynu Databricks
Zweryfikuj dane uwierzytelniania przechowywania. Należy podać co najmniej jeden z elementów external_location_name lub url. Jeśli zostanie podany tylko jeden z nich, zostanie on użyty do weryfikacji. Jeśli oba te elementy zostaną podane, url zostanie użyta do weryfikacji i external_location_name zostanie zignorowana podczas sprawdzania nakładających się adresów URL.
Należy podać albo storage_credential_name, albo poświadczenia specyficzne dla chmury.
Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem poświadczeń magazynu albo mieć CREATE_EXTERNAL_LOCATION uprawnienia do magazynu metadanych i poświadczeń magazynu.
databricks storage-credentials validate [flags]
Opcje
--external-location-name string
Nazwa istniejącej lokalizacji zewnętrznej do zweryfikowania.
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
--read-only
Czy poświadczenie magazynu może być wykorzystywane wyłącznie do operacji odczytu?
--storage-credential-name string
Required.
--url string
Adres URL lokalizacji zewnętrznej do zweryfikowania.
Examples
Poniższy przykład weryfikuje poprawność poświadczenia magazynu dla lokalizacji zewnętrznej.
databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location
Poniższy przykład weryfikuje poświadczenia magazynu względem adresu URL.
databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path
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