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

Note

Эта информация относится к Интерфейсу командной строки Databricks версии 0.205 и выше. Интерфейс командной строки Databricks находится в общедоступной предварительной версии.

Использование интерфейса командной строки Databricks подчиняется лицензии Databricks и уведомлению о конфиденциальности Databricks, включая любые положения о данных использования.

Группа schemas команд в интерфейсе командной строки Databricks содержит команды для управления схемами в каталоге Unity. Схема — это второй слой трехуровневого пространства имен каталога Unity. Схема упорядочивает таблицы, представления и функции. См. Что такое схемы в Azure Databricks?.

Создание схем в Databricks

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

databricks schemas create NAME CATALOG_NAME [flags]

Arguments

NAME

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

CATALOG_NAME

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

Options

--comment string

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

--json JSON

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

--storage-root string

    Корневой URL-адрес хранилища для таблиц под управлением в схеме.

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

Examples

В следующем примере создается новая схема с именем analytics в каталоге main :

databricks schemas create analytics main

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

databricks schemas create analytics main --comment "Schema for analytics data"

databricks schemas удалить

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

databricks schemas delete FULL_NAME [flags]

Arguments

FULL_NAME

    Полное имя схемы.

Options

--force

    Принудительное удаление, даже если схема не пуста.

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

Examples

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

databricks schemas delete main.analytics

В следующем примере принудительно удаляется схема, даже если она не пуста:

databricks schemas delete main.analytics --force

получение схем databricks

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

databricks schemas get FULL_NAME [flags]

Arguments

FULL_NAME

    Полное имя схемы.

Options

--include-browse

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

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

Examples

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

databricks schemas get main.analytics

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

databricks schemas get main.analytics --include-browse

Список схем Databricks

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

databricks schemas list CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Родительский каталог для схем, представляющих интерес.

Options

--include-browse

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

--max-results int

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

--page-token string

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

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

Examples

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

databricks schemas list main

В следующем примере перечислены схемы с максимум 10 результатами:

databricks schemas list main --max-results 10

В следующем примере перечислены схемы с помощью разбиения на страницы.

databricks schemas list main --page-token <token>

Обновление схем Databricks

Обновите схему каталога. Вызывающий объект должен быть владельцем схемы или администратора хранилища метаданных. Если вызывающий объект является администратором хранилища метаданных, в обновлении можно изменить только owner поле. name Если поле должно быть обновлено, вызывающий объект должен быть администратором хранилища метаданных или иметь привилегии CREATE_SCHEMA в родительском каталоге.

databricks schemas update FULL_NAME [flags]

Arguments

FULL_NAME

    Полное имя схемы.

Options

--comment string

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

--enable-predictive-optimization EnablePredictiveOptimization

    Следует ли включить прогнозную оптимизацию для этого объекта и объектов под ним. Поддерживаемые значения: [ОТКЛЮЧЕНО, ВКЛЮЧЕНО, НАСЛЕДОВАНИЕ]

--json JSON

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

--new-name string

    Новое имя схемы.

--owner string

    Имя пользователя текущего владельца схемы.

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

Examples

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

databricks schemas update main.analytics --comment "Updated analytics schema"

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

databricks schemas update main.analytics --owner someone@example.com

Следующий пример переименовывает схему:

databricks schemas update main.analytics --new-name analytics_v2

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

--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 струна

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