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

Note

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

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

Группа catalogs команд в интерфейсе командной строки Databricks позволяет управлять каталогами в каталоге Unity. Каталог является первым слоем трехуровневого пространства имен каталога Unity. Он используется для упорядочивания ресурсов данных. См. статью Что такое Unity Catalog?

Создание каталогов Databricks

Создайте новый экземпляр каталога в родительском хранилище метаданных, если вызывающий объект является администратором хранилища метаданных или имеет CREATE_CATALOG права.

databricks catalogs create NAME [flags]

Arguments

NAME

    Имя каталога

Options

--comment string

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

--connection-name string

    Имя подключения к внешнему источнику данных

--json JSON

    Встроенная строка JSON или JSON-файл @path с текстом запроса

--provider-name string

    Имя поставщика delta sharing

--share-name string

    Название ресурса общего доступа у поставщика общего доступа

--storage-root string

    URL-адрес корневого хранилища для управляемых таблиц в каталоге

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

Examples

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

databricks catalogs create sales

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

databricks catalogs create sales --comment "Sales data catalog"

Удаление каталогов Databricks

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

databricks catalogs delete NAME [flags]

Arguments

NAME

    Имя каталога

Options

--force

    Принудительное удаление, даже если каталог не пуст

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

Examples

В следующем примере удаляется каталог с именем sales:

databricks catalogs delete sales

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

databricks catalogs delete sales --force

Запросить каталоги Databricks

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

databricks catalogs get NAME [flags]

Arguments

NAME

    Имя каталога

Options

--include-browse

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

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

Examples

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

databricks catalogs get sales

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

databricks catalogs get sales --include-browse

список каталогов databricks

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

databricks catalogs list [flags]

Options

--include-browse

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

--max-results int

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

--page-token string

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

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

Examples

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

databricks catalogs list

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

databricks catalogs list --max-results 10

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

databricks catalogs list --include-browse

Обновления каталогов Databricks

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

databricks catalogs update NAME [flags]

Arguments

NAME

    Имя каталога

Options

--comment string

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

--enable-predictive-optimization EnablePredictiveOptimization

    Следует ли включить прогнозную оптимизацию для этого объекта и объектов под ним. Поддерживаемые значения: DISABLE, ENABLE, INHERIT

--isolation-mode CatalogIsolationMode

    Доступен ли текущий защищаемый объект из всех рабочих областей или определенного набора рабочих областей. Поддерживаемые значения: ISOLATED, OPEN

--json JSON

    Встроенная строка JSON или JSON-файл @path с текстом запроса

--new-name string

    Новое имя каталога

--owner string

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

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

Examples

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

databricks catalogs update sales --comment "Updated sales data catalog"

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

databricks catalogs update sales --new-name sales-prod

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

databricks catalogs update sales --owner someone@example.com

Следующий пример включает прогнозную оптимизацию для каталога:

databricks catalogs update sales --enable-predictive-optimization ENABLE

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

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

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