Поделиться через

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

Note

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

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

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

Доля — это контейнер, создаваемый в качестве экземпляра shares create. После создания вы можете итеративно зарегистрировать коллекцию существующих ресурсов данных, определенных в хранилище метаданных с помощью shares update. Вы можете зарегистрировать ресурсы данных под их исходным именем, уточненным их исходной схемой, или назначить им альтернативные открытые имена.

создание общих папок databricks

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

databricks shares create NAME [flags]

Arguments

NAME

    Название ресурса.

Options

--comment string

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

--json JSON

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

--storage-root string

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

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

Examples

В следующих примерах создается общая папка my-analytics-share с комментарием:

databricks shares create my-analytics-share --comment "Sales analytics data share"

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

databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"

удаление общих папок databricks

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

databricks shares delete NAME [flags]

Arguments

NAME

    Имя общей папки.

Options

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

Examples

В следующем примере удаляется общая папка с именем my-analytics-share:

databricks shares delete my-analytics-share

Акции Databricks получают

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

databricks shares get NAME [flags]

Arguments

NAME

    Имя общей папки.

Options

--include-shared-data

    Запрос данных для включения в общий доступ.

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

Examples

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

databricks shares get my-analytics-share

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

databricks shares get my-analytics-share --include-shared-data

Устаревший список акций databricks

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

databricks shares list [flags]

Arguments

None

Options

--max-results int

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

--page-token string

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

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

databricks предоставляет список общих папок

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

databricks shares list-shares [flags]

Arguments

None

Options

--max-results int

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

--page-token string

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

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

Examples

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

databricks shares list-shares

обновление акций Databricks

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

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

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

Если в общей папке есть файлы записной книжки, storage_root поле не может быть обновлено.

Для каждой таблицы, добавляемой с помощью этого метода, владелец общего ресурса также должен иметь SELECT привилегии в таблице. Эта привилегия должна поддерживаться на неопределенный срок, чтобы получатели могли получить доступ к таблице. Как правило, в качестве владельца общего ресурса следует использовать группу.

Удаление таблиц через update не требует дополнительных привилегий.

databricks shares update NAME [flags]

Arguments

NAME

    Имя общей папки.

Options

--comment string

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

--json JSON

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

--new-name string

    Новое имя для общего ресурса.

--owner string

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

--storage-root string

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

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

Examples

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

databricks shares update my-analytics-share --comment "Updated sales analytics data share"

В следующем примере изменяется название ресурса.

databricks shares update my-analytics-share --new-name "sales-analytics-share"

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

databricks shares update my-analytics-share --owner "someone@example.com"

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

databricks shares update my-analytics-share --json '{
  "comment": "Updated share with new tables",
  "objects": [
    {
      "name": "sales.customers",
      "data_object_type": "TABLE"
    }
  ]
}'

databricks предоставляет общие разрешения на общий доступ

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

databricks shares share-permissions NAME [flags]

Arguments

NAME

    Имя общей папки.

Options

--max-results int

    Максимальное количество разрешений для возврата.

--page-token string

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

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

Examples

В следующем примере получаются разрешения для папки общего доступа под названием my-analytics-share:

databricks shares share-permissions my-analytics-share

databricks предоставляет общие разрешения на обновление

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

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

databricks shares update-permissions NAME [flags]

Arguments

NAME

    Имя общей папки.

Options

--json JSON

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

--omit-permissions-list

    Optional.

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

Examples

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

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "add": ["SELECT"]
    }
  ]
}'

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

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "remove": ["SELECT"]
    }
  ]
}'

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

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

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

  • Last updated on