ALTER CONNECTION

применимо:отмечено Databricks SQL отмечено Databricks Runtime 13.3 LTS и выше отмечено Только для каталога Unity

Передает владение подключением новому субъекту, переименовывает подключение или изменяет параметры подключения.

Чтобы задать комментарий для подключения, используйте COMMENT ON CONNECTION.

Это важно

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

Синтаксис

ALTER CONNECTION connection_name
 { [ SET ] OWNER TO principal |
   RENAME TO new_connection_name |
   OPTIONS ( option value [, ...] )

Параметры

  • connection_name

    Имя соединения, которое нужно изменить.

  • [ SET ] ВЛАДЕЛЕЦ TO принципал

    Передает право собственности на подключение principal.

  • ПЕРЕИМЕНОВАТЬ В new_connection_name

    Задает новое имя подключения. Имя должно быть уникальным в хранилище метаданных каталога Unity.

  • OPTIONS

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

    Заменяет существующий список параметров новым списком параметров.

    • Параметр

      Ключ свойства. Ключ может состоять из одного или нескольких идентификаторов, разделенных точкой или STRING литералом.

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

    • значение

      Значение для свойства. Значение должно быть выражением BOOLEAN, STRINGINTEGERили DECIMALконстантой.

      Для любого варианта, который содержит учетные данные, например пароль или маркер, используйте secret функцию вместо прямого ввода значения. Например, укажите value значение passwordsecret('secrets.r.us', 'postgresPassword') вместо ввода литерального пароля.

Примеры

> ALTER CONNECTION mysql_connection SET OWNER TO `alf@melmak.et`;

> ALTER CONNECTION mysql_connection RENAME TO `other_mysql_connection`;

> ALTER CONNECTION mysql_connection OPTIONS (host 'newmysqlhost.us-west-2.amazonaws.com', port '3306');