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 Unity Catalog

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

Verwenden Sie COMMENT ON CONNECTION, um einen Kommentar für eine Verbindung festzulegen.

Important

Wenn Sie Verbindungsoptionen ändern, geben Sie Anmeldeinformationen wie Kennwörter und Token mithilfe der secret Funktion an, anstatt die Literalwerte direkt in die OPTIONS Klausel einzugeben. Auf diese Weise können Sie auf einen geheimen Schlüssel verweisen, der im Databricks-Geheimdienst gespeichert ist, anstatt den Anmeldeinformationswert in Ihre Anweisung einzuverlagern.

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 ] EIGENTÜMER ZU principal

    Überträgt den Besitz der Verbindung an principal.

  • IN NEW_CONNECTION_NAME UMBENENNEN

    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 BOOLEAN, STRING, , INTEGERoder DECIMALkonstanter Ausdruck sein.

      Verwenden Sie für jede Option, die anmeldeinformationen enthält, z. B. ein Kennwort oder ein Token, die secret Funktion, anstatt den Wert direkt einzugeben. Geben Sie z. B. nicht das valuepasswordsecret('secrets.r.us', 'postgresPassword') Literalkennwort ein.

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');
  • Last updated on