Udostępnij przez


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.

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