ALTER IDENTITY PROVIDER - Amazon Redshift
SyntaxeParamètresExemples

Amazon Redshift ne prendra plus en charge la création de nouveaux Python UDFs à compter du 1er novembre 2025. Si vous souhaitez utiliser Python UDFs, créez la version UDFs antérieure à cette date. Le Python existant UDFs continuera à fonctionner normalement. Pour plus d'informations, consultez le billet de blog.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ALTER IDENTITY PROVIDER

Modifie un fournisseur d’identité pour attribuer de nouveaux paramètres et de nouvelles valeurs. Lorsque vous exécutez cette commande, toutes les valeurs de paramètre précédemment définies sont supprimées avant que les nouvelles valeurs ne soient attribuées. Seul un super-utilisateur peut modifier un fournisseur d’identité.

Syntaxe

ALTER IDENTITY PROVIDER identity_provider_name
[PARAMETERS parameter_string]
[NAMESPACE namespace]
[IAM_ROLE iam_role]
[AUTO_CREATE_ROLES
    [ TRUE [ { INCLUDE | EXCLUDE } GROUPS LIKE filter_pattern] |
      FALSE
    ]
[DISABLE | ENABLE]

Paramètres

identity_provider_name

Nom du nouveau fournisseur d’identité. Pour plus d’informations sur les noms valides, consultez Noms et identificateurs.

parameter_string

Chaîne contenant un objet JSON correctement formaté qui contient des paramètres et des valeurs requis pour le fournisseur d’identité spécifique.

espace de nom

L'espace de noms de l'organisation.

iam_role

Rôle IAM qui fournit des autorisations pour la connexion à IAM Identity Center. Ce paramètre est applicable uniquement lorsque le type de fournisseur d'identité est. AWSIDC

auto_create_roles

Active ou désactive la fonctionnalité de création automatique des rôles. Si la valeur est VRAI, Amazon Redshift active la fonctionnalité de création automatique des rôles. Si la valeur est FALSE, Amazon Redshift désactive la fonctionnalité de création automatique des rôles. Si la valeur de ce paramètre n'est pas spécifiée, Amazon Redshift détermine la valeur selon la logique suivante :

  • S'il AUTO_CREATE_ROLES est fourni mais que la valeur n'est pas spécifiée, la valeur est définie sur TRUE.

  • Si AUTO_CREATE_ROLES ce n'est pas le cas et que le fournisseur d'identité l'est AWSIDC, la valeur est définie sur FALSE.

  • Si AUTO_CREATE_ROLES ce n'est pas le cas et que le fournisseur d'identité est Azure, la valeur est définie sur TRUE.

Pour inclure des groupes, spécifiezINCLUDE. La valeur par défaut est vide, ce qui signifie inclure tous les groupes si cette option AUTO_CREATE_ROLES est activée.

Pour exclure des groupes, spécifiezEXCLUDE. La valeur par défaut est vide, ce qui signifie qu'il ne faut exclure aucun groupe si cette option AUTO_CREATE_ROLES est activée.

filter_pattern

Expression de caractères UTF-8 valide avec un modèle correspondant aux noms de groupes. L’option LIKE effectue une mise en correspondance sensible à la casse qui prend en charge les métacaractères de mise en correspondance de modèle suivants :

Métacaractère Description
% Met en correspondance une séquence de zéro ou plusieurs caractères.
_ Met en correspondance un seul caractère.

Si filter_pattern ne contient pas de métacaractères, le modèle représente uniquement la chaîne elle-même ; dans ce cas, LIKE a la même fonction que l’opérateur d’égalité.

filter_pattern prend en charge les caractères suivants :

  • Caractères alphabétiques majuscules et minuscules (A-Z et a-z)

  • Chiffres (0-9)

  • Les caractères spéciaux suivants : 

    _ % ^ * + ? { } , $
DÉSACTIVER ou ACTIVER

Active ou désactive un fournisseur d'identité. La valeur par défaut est ENABLE.

Exemples

L’exemple suivant montre comment modifier un fournisseur d’identité nommé oauth_standard. Cela s'applique spécifiquement aux cas où Microsoft Azure AD est le fournisseur d'identité.

ALTER IDENTITY PROVIDER oauth_standard
PARAMETERS '{"issuer":"https://sts.windows.net/2sdfdsf-d475-420d-b5ac-667adad7c702/",
"client_id":"87f4aa26-78b7-410e-bf29-57b39929ef9a",
"client_secret":"BUAH~ewrqewrqwerUUY^%tHe1oNZShoiU7",
"audience":["https://analysis.windows.net/powerbi/connector/AmazonRedshift"]
}'

L'exemple suivant montre comment définir l'espace de noms du fournisseur d'identité. Cela peut s'appliquer à Microsoft Azure AD, s'il suit une instruction comme dans l'exemple précédent, ou à un autre fournisseur d'identité. Cela peut également s'appliquer au cas où vous connectez un cluster provisionné Amazon Redshift existant ou un groupe de travail Amazon Redshift Serverless à IAM Identity Center, si vous avez établi une connexion via une application gérée.

ALTER IDENTITY PROVIDER "my-redshift-idc-application"
NAMESPACE 'MYCO';

L'exemple suivant définit le rôle IAM et fonctionne dans le cas d'utilisation pour configurer l'intégration de Redshift avec IAM Identity Center.

ALTER IDENTITY PROVIDER "my-redshift-idc-application"
IAM_ROLE 'arn:aws:iam::123456789012:role/myadministratorrole';

Pour plus d'informations sur la configuration d'une connexion à IAM Identity Center depuis Redshift, voir Connect Redshift à IAM Identity Center pour offrir aux utilisateurs une expérience d'authentification unique.

Désactivation d'un fournisseur d'identité

L'exemple d'instruction suivant montre comment désactiver un fournisseur d'identité. Lorsqu'il est désactivé, les utilisateurs fédérés du fournisseur d'identité ne peuvent pas se connecter au cluster tant qu'il n'est pas réactivé.

ALTER IDENTITY PROVIDER "redshift-idc-app" DISABLE;