ALTER CONNECTION

Si applica a:contrassegnato con sì Databricks SQL contrassegnato con sì Databricks Runtime 13.3 LTS e versioni successive contrassegnato con sì solo Unity Catalog

Trasferisce la proprietà di una connessione a una nuova entità, rinomina una connessione o modifica le opzioni di connessione.

Per impostare un commento su una connessione, utilizzare COMMENT ON CONNECTION.

Importante

Quando si impostano le opzioni di connessione che contengono credenziali, ad esempio una password o un token, per mantenerle sicure, fornire il valore usando la secret funzione anziché immettere il valore letterale direttamente nella OPTIONS clausola . In questo modo è possibile fare riferimento a un segreto archiviato nel servizio segreto Databricks anziché includere il valore delle credenziali nell'istruzione.

Sintassi

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

Parametri

  • nome_connessione

    Nome della connessione da modificare.

  • [ SET ] PROPRIETARIO A principale

    Trasferisce la proprietà della connessione a principal.

  • RINOMINA IN nuovo_nome_connessione

    Specifica un nuovo nome per la connessione. Il nome deve essere univoco all'interno del metastore del Catalogo Unity.

  • OPTIONS

    Imposta connection_type parametri specifici necessari per stabilire la connessione.

    Sostituisce l'elenco di opzioni esistente con un nuovo elenco di opzioni.

    • opzione

      Chiave della proprietà. La chiave può essere costituita da uno o più identificatori separati da un punto o da un valore letterale STRING.

      Le chiavi delle proprietà devono essere uniche e sensibili alla distinzione tra maiuscole e minuscole.

    • value

      Il valore per la proprietà. Il valore deve essere un'espressione BOOLEANSTRING , INTEGERDECIMAL, o .

      Per qualsiasi opzione che contiene credenziali, ad esempio una password o un token, usare la secret funzione anziché immettere direttamente il valore. Ad esempio, specificare per valuepassword come secret('secrets.r.us', 'postgresPassword') anziché immettere la password letterale.

Esempi

> 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