tables 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 komend tables w CLI Databricks zawiera polecenia do zarządzania tabelami w Unity Catalog. Tabela znajduje się w trzeciej warstwie trzy-poziomowej przestrzeni nazw Unity Catalog. Zawiera wiersze danych.

Tworzenie tabel usługi databricks

Utwórz nową tabelę w określonym wykazie i schemacie.

Note

Ten interfejs API obsługuje tylko tworzenie zewnętrznych tabel delty. Obsługiwane są tylko TABLE_TYPE=EXTERNAL i DATA_SOURCE_FORMAT=DELTA. Maski kolumn nie są obsługiwane podczas tworzenia tabel za pośrednictwem tego interfejsu API.

Aby utworzyć zewnętrzną tabelę delty, obiekt wywołujący musi znajdować się EXTERNAL_USE_SCHEMA w schemacie nadrzędnym i EXTERNAL_USE_LOCATION w lokalizacji zewnętrznej oprócz standardowych USE_CATALOGuprawnień , CREATE_TABLE, USE_SCHEMAi CREATE_EXTERNAL_TABLE . Pole columns musi być w formacie zgodnym z platformą Spark.

databricks tables create NAME CATALOG_NAME SCHEMA_NAME TABLE_TYPE DATA_SOURCE_FORMAT STORAGE_LOCATION [flags]

Arguments

NAME

    Nazwa tabeli względem schematu nadrzędnego.

CATALOG_NAME

    Nazwa wykazu nadrzędnego.

SCHEMA_NAME

    Nazwa schematu nadrzędnego względem katalogu nadrzędnego.

TABLE_TYPE

    Typ tabeli. Obsługiwane wartości: EXTERNAL, EXTERNAL_SHALLOW_CLONEMATERIALIZED_VIEWMANAGEDFOREIGNMANAGED_SHALLOW_CLONE, METRIC_VIEW, , . VIEWSTREAMING_TABLE

DATA_SOURCE_FORMAT

    Format źródła danych tabeli. Obsługiwane wartości: AVRO, CSVICEBERGDELTAHIVETEXTDELTASHARINGJSONORCPARQUETi inne.

STORAGE_LOCATION

    Główny adres URL magazynu dla tabeli (wymagany dla MANAGED tabel i EXTERNAL ).

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path, wskazujący na plik JSON zawierający treść żądania.

Flagi globalne

Examples

Poniższy przykład tworzy zewnętrzną tabelę delty:

databricks tables create my_table my_catalog my_schema EXTERNAL DELTA s3://my-bucket/my-table

usuwanie tabel databricks

Usuń tabelę z określonego katalogu nadrzędnego i schematu. Obiekt wywołujący musi być właścicielem katalogu nadrzędnego, mieć uprawnienia USE_CATALOG do tego katalogu i być właścicielem schematu nadrzędnego albo być właścicielem tabeli, posiadać uprawnienia USE_CATALOG do katalogu nadrzędnego oraz uprawnienia USE_SCHEMA do schematu nadrzędnego.

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

    Pełna nazwa tabeli.

Opcje

Flagi globalne

Examples

Poniższy przykład usuwa tabelę:

databricks tables delete my_catalog.my_schema.my_table

Tabele w Databricks istnieją

Sprawdź, czy tabela istnieje w magazynie metadanych dla określonego katalogu i schematu. Obiekt wywołujący musi spełnić jedno z następujących wymagań:

• Zostań administratorem magazynu metadanych
• Zostań właścicielem wykazu nadrzędnego
• Być właścicielem schematu nadrzędnego i mieć USE_CATALOG uprawnienia do katalogu nadrzędnego
• Musisz mieć uprawnienie USE_CATALOG do katalogu nadrzędnego i uprawnienie USE_SCHEMA do schematu nadrzędnego oraz być właścicielem tabeli lub posiadać uprawnienie SELECT do tabeli.
• Uprawnienie BROWSE do katalogu nadrzędnego
• Musisz mieć BROWSE uprawnienia do schematu nadrzędnego.

databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

    Pełna nazwa tabeli.

Opcje

Flagi globalne

Examples

Poniższy przykład sprawdza, czy tabela istnieje:

databricks tables exists my_catalog.my_schema.my_table

pobieranie informacji o tabelach Databricks

Pobierz tabelę z magazynu metadanych dla określonego katalogu i schematu. Obiekt wywołujący musi spełnić jedno z następujących wymagań:

• Zostań administratorem magazynu metadanych
• Zostań właścicielem wykazu nadrzędnego
• Być właścicielem schematu nadrzędnego i mieć USE_CATALOG uprawnienia do katalogu nadrzędnego
• Musisz mieć uprawnienie USE_CATALOG do katalogu nadrzędnego i uprawnienie USE_SCHEMA do schematu nadrzędnego oraz być właścicielem tabeli lub posiadać uprawnienie SELECT do tabeli.

databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

    Pełna nazwa tabeli.

Opcje

--include-browse

    Określa, czy należy uwzględnić tabele w odpowiedzi, do których podmiot może uzyskiwać dostęp tylko do wybranych metadanych.

--include-delta-metadata

    Określa, czy metadane różnicowe powinny być uwzględnione w odpowiedzi.

--include-manifest-capabilities

    Określa, czy należy uwzględnić manifest zawierający możliwości, które zawiera tabela.

Flagi globalne

Examples

Poniższy przykład pobiera informacje o tabeli:

databricks tables get my_catalog.my_schema.my_table

Poniższy przykład pobiera tabelę z uwzględnionymi metadanymi delta:

databricks tables get my_catalog.my_schema.my_table --include-delta-metadata

lista tabel usługi databricks

Wyświetl listę wszystkich tabel w bieżącym repozytorium metadanych w katalogu nadrzędnym i schemacie. Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem tabeli (lub mieć SELECT uprawnienia do tej tabeli). W tym ostatnim przypadku obiekt wywołujący musi być również właścicielem lub mieć USE_CATALOG uprawnienie do katalogu nadrzędnego i USE_SCHEMA uprawnienie w schemacie nadrzędnym. Nie ma gwarancji, że istnieje określona kolejność elementów w tablicy.

databricks tables list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Nazwa katalogu nadrzędnego dla interesujących tabel.

SCHEMA_NAME

    Nadrzędny schemat tabel.

Opcje

--include-browse

    Określa, czy należy uwzględnić tabele w odpowiedzi, do których podmiot może uzyskiwać dostęp tylko do wybranych metadanych.

--include-delta-metadata

    Określa, czy metadane różnicowe powinny być uwzględnione w odpowiedzi.

--include-manifest-capabilities

    Określa, czy należy uwzględnić manifest zawierający możliwości, które zawiera tabela.

--max-results int

    Maksymalna liczba tabel do zwrócenia.

--omit-columns

    Czy pominąć kolumny tabeli z odpowiedzi, czy nie.

--omit-properties

    Czy pominąć właściwości tabeli z odpowiedzi, czy nie.

--omit-username

    Czy pominąć nazwę użytkownika tabeli (np.

--page-token string

    Nieprzezroczysty token do wysłania dla następnej strony wyników (stronicowanie).

Flagi globalne

Examples

W poniższym przykładzie wymieniono wszystkie tabele w wykazie i schemacie:

databricks tables list my_catalog my_schema

W poniższym przykładzie wymieniono tabele z pominiętymi kolumnami:

databricks tables list my_catalog my_schema --omit-columns

listowanie podsumowań tabel Databricks

Lista podsumowań tabel dla schematu i katalogu w systemie przechowywania metadanych. Zwrócone podsumowania tabeli są następujące:

• podsumowania tabel (w bieżącym magazynie metadanych oraz katalogu nadrzędnego i schematu), gdy użytkownik jest administratorem magazynu metadanych,
• lub podsumowania tabel i schematów (w bieżącym magazynie metadanych i katalogu nadrzędnym), dla których użytkownik posiada własność lub SELECT uprawnienia w tabeli oraz własność lub USE_SCHEMA uprawnienia w schemacie, pod warunkiem, że użytkownik posiada również własność lub USE_CATALOG uprawnienia w katalogu nadrzędnym.

Nie ma gwarancji, że istnieje określona kolejność elementów w tablicy.

databricks tables list-summaries CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Nazwa katalogu nadrzędnego dla interesujących tabel.

Opcje

--include-manifest-capabilities

    Określa, czy należy uwzględnić manifest zawierający możliwości, które zawiera tabela.

--max-results int

    Maksymalna liczba podsumowań zwracanych tabel.

--page-token string

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

--schema-name-pattern string

    Wzorzec SQL LIKE (% i _) dla nazw schematów.

--table-name-pattern string

    Wzorzec SQL LIKE (% i _) dla nazw tabel.

Flagi globalne

Examples

W poniższym przykładzie znajdują się podsumowania tabel w katalogu.

databricks tables list-summaries my_catalog

W poniższym przykładzie wymieniono podsumowania tabeli ze wzorcem nazwy schematu:

databricks tables list-summaries my_catalog --schema-name-pattern "prod_%"

W poniższym przykładzie wymieniono podsumowania tabeli ze wzorcem nazwy tabeli:

databricks tables list-summaries my_catalog --table-name-pattern "fact_%"

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