ALTER CONNECTION

S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 13.3 LTS et versions ultérieures cochée oui Unity Catalog uniquement

Transfère la propriété d’une connexion à un nouveau principal, renomme une connexion ou modifie les options de connexion.

Pour définir un commentaire sur une connexion, utilisez COMMENT ONCONNECTION .

Important

Lorsque vous modifiez les options de connexion, fournissez des informations d’identification telles que des mots de passe et des jetons à l’aide de la secret fonction plutôt que d’entrer les valeurs littérales directement dans la OPTIONS clause. Cela vous permet de référencer un secret stocké dans le service secret Databricks au lieu d’inclure la valeur d’informations d’identification dans votre instruction.

Syntaxe

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

Paramètres

  • connection_name

    Nom de la connexion à modifier.

  • [ SET ] PROPRIÉTAIRE À principal

    Transfère la propriété de la connexion vers principal.

  • RENOMMER EN new_connection_name

    Spécifie un nouveau nom pour la connexion. Le nom doit être unique dans le metastore Unity Catalog.

  • OPTIONS

    Définie les paramètres spécifiques connection_type obligatoires pour établir la connexion.

    Remplace la liste d’options existante par une nouvelle liste d’options.

    • option

      Clé de la propriété. La clé peut comporter un ou plusieurs identificateurs séparés par un point, ou un littéral STRING.

      Les clés de propriété doivent être uniques et respectent la casse.

    • value

      Valeur de la propriété. La valeur doit être une BOOLEANSTRING , INTEGERDECIMALou constante.

      Pour toute option qui contient des informations d’identification, telles qu’un mot de passe ou un jeton, utilisez la secret fonction au lieu d’entrer la valeur directement. Par exemple, indiquez le value mot secret('secrets.r.us', 'postgresPassword')password de passe littéral plutôt que d’entrer le mot de passe littéral.

Exemples

> 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