Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
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 external-locations poleceń w CLI Databricks zawiera polecenia służące do tworzenia i zarządzania lokalizacjami zewnętrznymi dla Unity Catalog. Zobacz Czym są wolumeny Unity Catalog?.
databricks tworzenie lokalizacji zewnętrznych
Utwórz nowy wpis lokalizacji zewnętrznej w magazynie metadanych. Obiekt wywołujący musi być administratorem metadanych lub mieć CREATE_EXTERNAL_LOCATION uprawnienie zarówno do magazynu metadanych, jak i skojarzonego poświadczenia magazynowego.
databricks external-locations create NAME URL CREDENTIAL_NAME [flags]
Arguments
NAME
Nazwa lokalizacji zewnętrznej.
URL
Adres URL ścieżki lokalizacji zewnętrznej.
CREDENTIAL_NAME
Nazwa poświadczenia do magazynu używanego w tej lokalizacji.
Opcje
--comment string
Opis tekstu w formie dowolnej, podany przez użytkownika.
--enable-file-events
Czy włączyć zdarzenia plików w tej lokalizacji zewnętrznej.
--fallback
Wskazuje, czy dla tej lokalizacji zewnętrznej jest włączony tryb rezerwowy.
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
--read-only
Wskazuje, czy lokalizacja zewnętrzna jest tylko do odczytu.
--skip-validation
Pomija walidację poświadczeń magazynowych skojarzonych z zewnętrzną lokalizacją.
Examples
Poniższy przykład tworzy lokalizację zewnętrzną z komentarzem:
databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"
Poniższy przykład tworzy lokalizację zewnętrzną tylko do odczytu:
databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only
usuwanie lokalizacji zewnętrznych usługi databricks
Usuń określoną lokalizację zewnętrzną z repozytorium metadanych. Wywołujący musi być właścicielem lokalizacji zewnętrznej.
databricks external-locations delete NAME [flags]
Arguments
NAME
Nazwa lokalizacji zewnętrznej.
Opcje
--force
Wymuś usunięcie, nawet jeśli istnieją zależne tabele zewnętrzne lub instalacja.
Examples
Poniższy przykład usuwa lokalizację zewnętrzną o nazwie my-external-location:
databricks external-locations delete my-external-location
Poniższy przykład wymusza usunięcie lokalizacji zewnętrznej, nawet jeśli istnieją zależności:
databricks external-locations delete my-external-location --force
databricks uzyskaj lokalizacje zewnętrzne
Pobierz lokalizację zewnętrzną z magazynu metadanych. Obiekt wywołujący musi być administratorem magazynu metadanych, właścicielem lokalizacji zewnętrznej lub użytkownikiem posiadającym określone uprawnienia do lokalizacji zewnętrznej.
databricks external-locations get NAME [flags]
Arguments
NAME
Nazwa lokalizacji zewnętrznej.
Opcje
--include-browse
Określa, czy należy uwzględnić lokalizacje zewnętrzne w odpowiedzi, do których podmiot ma dostęp tylko do wybranych metadanych.
Examples
Poniższy przykład pobiera informacje o lokalizacji zewnętrznej o nazwie my-external-location:
databricks external-locations get my-external-location
Poniższy przykład pobiera informacje, w tym metadane dotyczące przeglądania:
databricks external-locations get my-external-location --include-browse
lista lokalizacji zewnętrznych Databricks
Wyświetl listę lokalizacji zewnętrznych z magazynu metadanych. Obiekt wywołujący musi być administratorem magazynu metadanych, właścicielem lokalizacji zewnętrznej lub użytkownikiem, który ma pewne uprawnienia w lokalizacji zewnętrznej. Nie ma żadnej gwarancji, że określona kolejność elementów w tablicy.
databricks external-locations list [flags]
Opcje
--include-browse
Określa, czy należy uwzględnić lokalizacje zewnętrzne w odpowiedzi, do których podmiot ma dostęp tylko do wybranych metadanych.
--include-unbound
Czy należy uwzględnić lokalizacje zewnętrzne, które nie są powiązane z obszarem roboczym.
--max-results int
Maksymalna liczba lokalizacji zewnętrznych, które należy zwrócić.
--page-token string
Nieprzezroczystym tokenem stronicowania, aby przejść do następnej strony na podstawie poprzedniego zapytania.
Examples
Poniższy przykład zawiera listę wszystkich lokalizacji zewnętrznych:
databricks external-locations list
Poniższy przykład zawiera listę lokalizacji zewnętrznych z maksymalnie 10 wynikami:
databricks external-locations list --max-results 10
aktualizacja lokalizacji zewnętrznych usługi databricks
Zaktualizuj lokalizację zewnętrzną w magazynie metadanych. Obiekt wywołujący musi być właścicielem lokalizacji zewnętrznej lub być administratorem magazynu metadanych. W drugim przypadku administrator może zaktualizować tylko nazwę lokalizacji zewnętrznej.
databricks external-locations update NAME [flags]
Arguments
NAME
Nazwa lokalizacji zewnętrznej.
Opcje
--comment string
Opis tekstu w formie dowolnej, podany przez użytkownika.
--credential-name string
Nazwa poświadczenia do magazynu używanego w tej lokalizacji.
--enable-file-events
Czy włączyć zdarzenia plików w tej lokalizacji zewnętrznej.
--fallback
Wskazuje, czy dla tej lokalizacji zewnętrznej jest włączony tryb rezerwowy.
--force
Wymuś aktualizację, nawet jeśli zmiana adresu URL powoduje unieważnienie zależnych tabel zewnętrznych lub punktów montowania.
--isolation-mode IsolationMode
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 lokalizacji zewnętrznej.
--owner string
Właściciel lokalizacji zewnętrznej.
--read-only
Wskazuje, czy lokalizacja zewnętrzna jest tylko do odczytu.
--skip-validation
Pomija walidację poświadczeń magazynowych skojarzonych z zewnętrzną lokalizacją.
--url string
Adres URL ścieżki lokalizacji zewnętrznej.
Examples
Poniższy przykład zmienia nazwę lokalizacji zewnętrznej:
databricks external-locations update my-external-location --new-name my-renamed-location
Poniższy przykład zmienia właściciela lokalizacji zewnętrznej:
databricks external-locations update my-external-location --owner someone@example.com
Flagi globalne
--debug
Czy włączyć rejestrowanie debugowania.
-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
Typ text formatu dziennika 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 text danych wyjściowych polecenia lub json. Wartość domyślna to text.
-p, --profile struna
Nazwa profilu w ~/.databrickscfg pliku 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, element docelowy pakietu do użycia