Freigeben über


ALTER CONNECTION

Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 13.3 LTS und höher durch Häkchen mit „Ja“ markiert nur für Unity Catalog

Überträgt das Eigentum an einer Verbindung an einen neuen Prinzipal, benennt eine Verbindung um oder ändert die Verbindungsoptionen.

Um einen Kommentar für eine Verbindung festzulegen, verwenden Sie COMMENT ON CONNECTION.

Syntax

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

Parameter

  • connection_name

    Der Name der Verbindung, die geändert werden soll.

  • [ SET ] OWNER TO principal

    Überträgt den Besitz der Verbindung an principal.

  • RENAME TO new_connection_name

    Gibt einen neuen Namen für die Verbindung an. Der Name muss innerhalb des Unity Catalog-Metastores eindeutig sein.

  • OPTIONS

    Legt connection_type-spezifische Parameter fest, die zum Herstellen der Verbindung erforderlich sind.

    Ersetzt die vorhandene Liste der Optionen durch eine neue Liste von Optionen.

    • Option

      Der Eigenschaftenschlüssel. Der Schlüssel kann aus einem oder mehreren Bezeichnern bestehen, die durch einen Punkt oder ein STRING-Literal getrennt sind.

      Eigenschaftenschlüssel müssen eindeutig sein, und die Groß-/Kleinschreibung muss beachtet werden.

    • value

      Der Wert für die Eigenschaft. Der Wert muss ein konstanter Ausdruck vom Typ BOOLEAN, STRING, INTEGER oder DECIMAL sein.

      Beispielsweise verwendet value für password den konstanten Ausdruck „secret('secrets.r.us', 'postgresPassword')“, anstatt das Literalkennwort einzugeben.

Beispiele

> 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');