tables группа команд

Группа tables команд в интерфейсе командной строки Databricks содержит команды для управления таблицами в каталоге Unity. Таблица находится на третьем уровне трехуровневого пространства имен каталога Unity. Он содержит строки данных.

Создание таблиц databricks

Создайте новую таблицу в указанном каталоге и схеме.

Чтобы создать внешнюю таблицу Delta, вызывающий объект должен иметь EXTERNAL_USE_SCHEMA родительскую схему и EXTERNAL_USE_LOCATION внешнее расположение в дополнение к стандартнымUSE_CATALOG, и CREATE_TABLEUSE_SCHEMACREATE_EXTERNAL_TABLE привилегиям. Поле columns должно находиться в формате, совместимом с Spark.

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

Arguments

NAME

    Имя таблицы относительно родительской схемы.

CATALOG_NAME

    Имя родительского каталога.

SCHEMA_NAME

    Имя родительской схемы относительно родительского каталога.

TABLE_TYPE

    Тип таблицы. Поддерживаемые значения: EXTERNAL, EXTERNAL_SHALLOW_CLONE, FOREIGN; MANAGEDMANAGED_SHALLOW_CLONEMATERIALIZED_VIEWMETRIC_VIEWSTREAMING_TABLEVIEW

DATA_SOURCE_FORMAT

    Формат источника данных таблицы. Поддерживаемые значения: AVRO, CSV, DELTADELTASHARINGHIVEICEBERGJSONORCPARQUETи TEXTдругие.

STORAGE_LOCATION

    URL-адрес корневого хранилища для таблицы (требуется для MANAGED и EXTERNAL таблиц).

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

Глобальные флаги

Examples

В следующем примере создается внешняя таблица Delta:

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

Удаление таблиц Databricks

Удалите таблицу из указанного родительского каталога и схемы. Вызывающий должен быть владельцем родительского каталога, иметь привилегии USE_CATALOG в родительском каталоге и быть владельцем родительской схемы; или быть владельцем таблицы, а также иметь привилегии USE_CATALOG в родительском каталоге и привилегии USE_SCHEMA в родительской схеме.

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

    Полное имя таблицы.

Options

Глобальные флаги

Examples

В следующем примере удаляется таблица:

databricks tables delete my_catalog.my_schema.my_table

Таблицы Databricks существуют

Получение сведений о наличии таблицы в хранилище метаданных для определенного каталога и схемы. Вызывающий должен соответствовать одному из следующих требований:

• Быть администратором хранилища метаданных
• Стать владельцем родительского каталога
• Быть владельцем родительской схемы и иметь привилегию USE_CATALOG в родительском каталоге
• USE_CATALOG Имейте привилегии на родительский каталог и USE_SCHEMA привилегии на родительскую схему, а также либо быть владельцем таблицы, либо иметь SELECT привилегии на таблицу.
• Иметь BROWSE привилегии в родительском каталоге
• У вас есть BROWSE привилегии на родительскую схему.

databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

    Полное имя таблицы.

Options

Глобальные флаги

Examples

В следующем примере проверяется, существует ли таблица:

databricks tables exists my_catalog.my_schema.my_table

Получение таблиц Databricks

Получите таблицу из хранилища метаданных для определенного каталога и схемы. Вызывающий должен соответствовать одному из следующих требований:

• Быть администратором хранилища метаданных
• Стать владельцем родительского каталога
• Быть владельцем родительской схемы и иметь привилегию USE_CATALOG в родительском каталоге
• USE_CATALOG Имейте привилегии на родительский каталог и USE_SCHEMA привилегии на родительскую схему, а также либо быть владельцем таблицы, либо иметь SELECT привилегии на таблицу.

databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

    Полное имя таблицы.

Options

--include-browse

    Следует ли включать таблицы в ответ, для которого субъект может получить доступ только к выборочным метаданным.

--include-delta-metadata

    Следует ли включать в ответ разностные метаданные.

--include-manifest-capabilities

    Следует ли включать манифест, содержащий возможности таблицы.

Глобальные флаги

Examples

В следующем примере показано, как получить сведения о таблице:

databricks tables get my_catalog.my_schema.my_table

В следующем примере возвращается таблица с разностными метаданными:

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

Список таблиц Databricks

Перечислите все таблицы в текущем хранилище метаданных в рамках родительского каталога и схемы. Вызывающий объект должен быть администратором хранилища метаданных или владельцем (или иметь SELECT права на таблицу). В последнем случае вызывающий объект также должен быть владельцем или иметь USE_CATALOG привилегии в родительском каталоге и USE_SCHEMA привилегии родительской схемы. Никакой гарантии упорядочения элементов в массиве нет.

databricks tables list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Имя родительского каталога для интересующих таблиц.

SCHEMA_NAME

    Базовая схема таблиц.

Options

--include-browse

    Следует ли включать таблицы в ответ, для которого субъект может получить доступ только к выборочным метаданным.

--include-delta-metadata

    Следует ли включать в ответ разностные метаданные.

--include-manifest-capabilities

    Следует ли включать манифест, содержащий возможности таблицы.

--max-results int

    Максимальное количество возвращаемых таблиц.

--omit-columns

    Следует ли опустить столбцы таблицы из ответа или нет.

--omit-properties

    Следует ли опустить свойства таблицы из ответа или нет.

--omit-username

    Опустите имя пользователя таблицы (например,

--page-token string

    Непрозрачный токен для отправки на следующую страницу результатов (разбиение на страницы).

Глобальные флаги

Examples

В следующем примере перечислены все таблицы в каталоге и схеме:

databricks tables list my_catalog my_schema

В следующем примере перечислены таблицы с опущенными столбцами:

databricks tables list my_catalog my_schema --omit-columns

таблицы databricks списки-сводки

Составление сводок для таблиц для схемы и каталога в метахранилище. Возвращаемые сводки таблицы могут быть:

• сводки для таблиц (в текущем хранилище метаданных и родительском каталоге и схеме), когда пользователь является администратором хранилища метаданных,
• или сводки для таблиц и схем (в текущем хранилище метаданных и родительском каталоге), для которых у пользователя есть право владения или SELECT привилегия на таблицу и право владения или USE_SCHEMA привилегия на схему, при условии, что пользователь также имеет право владения или USE_CATALOG привилегия в родительском каталоге.

Никакой гарантии упорядочения элементов в массиве нет.

databricks tables list-summaries CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Имя родительского каталога для интересующих таблиц.

Options

--include-manifest-capabilities

    Следует ли включать манифест, содержащий возможности таблицы.

--max-results int

    Максимальное количество сводок для возвращаемых таблиц.

--page-token string

    Непрозрачный маркер разбиения на страницы, чтобы перейти на следующую страницу на основе предыдущего запроса.

--schema-name-pattern string

    Шаблон SQL LIKE (% и _) для имен схем.

--table-name-pattern string

    Шаблон SQL LIKE (% и _) для имен таблиц.

Глобальные флаги

Examples

В следующем примере перечислены сводки таблиц для каталога:

databricks tables list-summaries my_catalog

В следующем примере перечислены сводки таблиц с шаблоном имени схемы:

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

В следующем примере перечислены сводки таблиц с шаблоном имени таблицы:

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

Глобальные флаги

--debug

  Следует ли включить ведение журнала отладки.

-h или --help

    Отобразить справку по интерфейсу командной строки Databricks, связанной группе команд или отдельной команде.

--log-file струна

    Строка, представляющая файл для записи журналов выходных данных. Если этот флаг не указан, по умолчанию используется запись журналов выходных данных в stderr.

--log-format формат

    Тип формата журнала: text или json. Значение по умолчанию — text.

--log-level струна

    Строка, представляющая уровень формата журнала. Если не указано, уровень формата журнала отключен.

типа -o, --output

    Тип выходных данных команды: text или json. Значение по умолчанию — text.

-p, --profile струна

    Имя профиля в ~/.databrickscfg файле, используемого для выполнения команды. Если флаг не указан, используется профиль DEFAULT, если он существует.

--progress-format формат

    Формат для отображения журналов хода выполнения: default, appendinplace, илиjson

-t, --target струна

    Если применимо, целевой объект пакета для использования