external-metadata grupa poleceń

Uwaga / Notatka

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-metadata poleceń w interfejsie wiersza polecenia usługi Databricks zawiera polecenia służące do rejestrowania metadanych dotyczących systemów zewnętrznych i zarządzania nimi w wykazie aparatu Unity.

databricks external-metadata create-external-metadata

Utwórz nowy obiekt metadanych zewnętrznych w nadrzędnym magazynie metadanych, jeśli obiekt wywołujący jest administratorem magazynu metadanych lub ma uprawnienia CREATE_EXTERNAL_METADATA . Domyślnie udziela opcji PRZEGLĄDAJ wszystkim użytkownikom konta podczas tworzenia.

databricks external-metadata create-external-metadata NAME SYSTEM_TYPE ENTITY_TYPE [flags]

Arguments

NAME

    Nazwa obiektu metadanych zewnętrznych.

SYSTEM_TYPE

    Typ systemu zewnętrznego. Obsługiwane wartości: AMAZON_REDSHIFT, AZURE_SYNAPSECONFLUENTDATABRICKSGOOGLE_BIGQUERYKAFKALOOKERMICROSOFT_FABRICMICROSOFT_SQL_SERVERMONGODBMYSQLORACLEOTHERPOSTGRESQLPOWER_BISALESFORCESAPSERVICENOWSNOWFLAKESTREAM_NATIVETABLEAUTERADATAWORKDAY

ENTITY_TYPE

    Typ jednostki w systemie zewnętrznym.

Opcje

--description string

    Opis tekstu w formie dowolnej, podany przez użytkownika.

--json JSON

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

--owner string

    Właściciel obiektu metadanych zewnętrznych.

--url string

    Adres URL skojarzony z obiektem metadanych zewnętrznych.

Flagi globalne

Przykłady

Poniższy przykład tworzy obiekt metadanych zewnętrznych dla tabeli Snowflake:

databricks external-metadata create-external-metadata my_snowflake_table SNOWFLAKE TABLE --description "Production sales table" --url "https://example.snowflakecomputing.com/table/sales"

Poniższy przykład tworzy obiekt metadanych zewnętrznych przy użyciu kodu JSON:

databricks external-metadata create-external-metadata tableau_dashboard TABLEAU DASHBOARD --json '{"description": "Sales dashboard", "owner": "user@example.com"}'

Poniższy przykład tworzy obiekt metadanych zewnętrznych przy użyciu pliku JSON:

databricks external-metadata create-external-metadata bigquery_dataset GOOGLE_BIGQUERY DATASET --json @external-metadata.json

databricks external-metadata delete-external-metadata

Usuń obiekt metadanych zewnętrznych, który jest zgodny z podaną nazwą. Obiekt wywołujący musi być administratorem magazynu metadanych, właścicielem obiektu metadanych zewnętrznych lub użytkownikiem z uprawnieniami ZARZĄDZANIA .

databricks external-metadata delete-external-metadata NAME [flags]

Arguments

NAME

    Nazwa obiektu metadanych zewnętrznych do usunięcia.

Opcje

Flagi globalne

Przykłady

Poniższy przykład usuwa obiekt metadanych zewnętrznych:

databricks external-metadata delete-external-metadata my_snowflake_table

databricks external-metadata get-external-metadata

Pobierz określony obiekt metadanych zewnętrznych w magazynie metadanych. Obiekt wywołujący musi być administratorem magazynu metadanych, właścicielem obiektu metadanych zewnętrznych lub użytkownikiem z uprawnieniami PRZEGLĄDANIa .

databricks external-metadata get-external-metadata NAME [flags]

Arguments

NAME

    Nazwa obiektu metadanych zewnętrznych do pobrania.

Opcje

Flagi globalne

Przykłady

Poniższy przykład pobiera obiekt metadanych zewnętrznych:

databricks external-metadata get-external-metadata my_snowflake_table

databricks external-metadata list-external-metadata

Wyświetlanie listy obiektów metadanych zewnętrznych w magazynie metadanych. Jeśli obiekt wywołujący jest administratorem magazynu metadanych, zostaną pobrane wszystkie zewnętrzne obiekty metadanych. W przeciwnym razie zostaną pobrane tylko zewnętrzne obiekty metadanych, na których obiekt wywołujący ma przycisk BROWSE . Nie ma gwarancji na określoną kolejność elementów w tablicy.

databricks external-metadata list-external-metadata [flags]

Opcje

--page-size int

    Maksymalna liczba obiektów metadanych zewnętrznych zwracanych na stronę.

--page-token string

    Token do pobrania następnej strony wyników.

Flagi globalne

Przykłady

Poniższy przykład zawiera listę wszystkich obiektów metadanych zewnętrznych:

databricks external-metadata list-external-metadata

W poniższym przykładzie wymieniono zewnętrzne obiekty metadanych z podziałem na strony:

databricks external-metadata list-external-metadata --page-size 10

databricks external-metadata update-external-metadata

Zaktualizuj obiekt metadanych zewnętrznych, który jest zgodny z podaną nazwą. Obiekt wywołujący może aktualizować tylko pola właściciela lub innych metadanych w jednym żądaniu. Obiekt wywołujący musi być administratorem magazynu metadanych, właścicielem obiektu metadanych zewnętrznych lub użytkownikiem z uprawnieniami MODIFY . Jeśli obiekt wywołujący aktualizuje właściciela, musi również mieć uprawnienia ZARZĄDZANIE .

databricks external-metadata update-external-metadata NAME UPDATE_MASK SYSTEM_TYPE ENTITY_TYPE [flags]

Arguments

NAME

    Nazwa obiektu metadanych zewnętrznych.

UPDATE_MASK

    Maska pól musi być pojedynczym ciągiem z wieloma polami rozdzielonymi przecinkami (bez spacji). Ścieżka pola jest względna względem obiektu zasobu, używając kropki (.), aby nawigować po polach podrzędnych (np. author.given_name). Specyfikacja elementów w polach sekwencji lub mapowania jest niedozwolona, ponieważ można określić tylko całe pole kolekcji. Nazwy pól muszą być dokładnie zgodne z nazwami pól zasobów.

    Symbol gwiazdki (*) w maskowaniu pola wskazuje pełne zastąpienie. Zaleca się, aby zawsze jawnie wyświetlać listę aktualizowanych pól i unikać używania symboli wieloznacznych, ponieważ może to prowadzić do niezamierzonych wyników, jeśli interfejs API ulegnie zmianie w przyszłości.

SYSTEM_TYPE

    Typ systemu zewnętrznego. Obsługiwane wartości: AMAZON_REDSHIFT, AZURE_SYNAPSECONFLUENTDATABRICKSGOOGLE_BIGQUERYKAFKALOOKERMICROSOFT_FABRICMICROSOFT_SQL_SERVERMONGODBMYSQLORACLEOTHERPOSTGRESQLPOWER_BISALESFORCESAPSERVICENOWSNOWFLAKESTREAM_NATIVETABLEAUTERADATAWORKDAY

ENTITY_TYPE

    Typ jednostki w systemie zewnętrznym.

Opcje

--description string

    Opis tekstu w formie dowolnej, podany przez użytkownika.

--json JSON

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

--owner string

    Właściciel obiektu metadanych zewnętrznych.

--url string

    Adres URL skojarzony z obiektem metadanych zewnętrznych.

Flagi globalne

Przykłady

Poniższy przykład aktualizuje opis obiektu metadanych zewnętrznych:

databricks external-metadata update-external-metadata my_snowflake_table "description" SNOWFLAKE TABLE --description "Updated production sales table"

Poniższy przykład aktualizuje właściciela obiektu metadanych zewnętrznych:

databricks external-metadata update-external-metadata my_snowflake_table "owner" SNOWFLAKE TABLE --owner "newowner@example.com"

Poniższy przykład aktualizuje obiekt metadanych zewnętrznych przy użyciu kodu JSON:

databricks external-metadata update-external-metadata my_snowflake_table "description,url" SNOWFLAKE TABLE --json '{"description": "Latest sales data", "url": "https://example.snowflakecomputing.com/table/sales_v2"}'

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 łańcuch znaków

    Ciąg tekstowy reprezentujący plik do zapisywania logó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. Domyślna wartość to text.

--log-level łańcuch znaków

    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. Domyślna wartość to text.

-p, --profile łańcuch znaków

    Nazwa profilu w pliku ~/.databrickscfg, który ma być użyty do uruchomienia polecenia. Jeśli ta flaga nie zostanie określona, to jeśli istnieje, zostanie użyty profil o nazwie DEFAULT.

--progress-format formatowanie

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

-t, --target łańcuch znaków

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