View a markdown version of this page

Connectez-vous à Amazon Redshift - AWS App Studio

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.

Connectez-vous à Amazon Redshift

Pour connecter App Studio à Amazon Redshift afin de permettre aux créateurs d'accéder aux ressources Amazon Redshift et de les utiliser dans les applications, vous devez suivre les étapes suivantes :

Étape 1 : Création et configuration des ressources Amazon Redshift

Suivez la procédure suivante pour créer et configurer les ressources Amazon Redshift à utiliser avec App Studio.

Pour configurer Amazon Redshift afin de l'utiliser avec App Studio
  1. Connectez-vous à Console de gestion AWS et ouvrez la console Amazon Redshift à https://console.aws.amazon.com/redshiftv2/ l'adresse.

    Nous vous recommandons d'utiliser l'utilisateur administratif créé dansInscrivez-vous pour un Compte AWS.

  2. Créez un entrepôt de données Redshift Serverless ou un cluster provisionné. Pour plus d'informations, consultez Création d'un entrepôt de données avec Redshift Serverless ou Création d'un cluster dans le guide de l'utilisateur Amazon Redshift.

  3. Une fois le provisionnement terminé, choisissez Query Data pour ouvrir l'éditeur de requêtes. Connectez-vous à votre base de données.

  4. Modifiez les paramètres suivants :

    1. Activez le bouton « Session isolée » surOFF. Cela est nécessaire pour que vous puissiez voir les modifications de données apportées par d'autres utilisateurs, par exemple à partir d'une application App Studio en cours d'exécution.

    2. Choisissez l'icône « engrenage ». Choisissez Account settings (Paramètres du compte). Augmentez le nombre maximum de connexions simultanées à10. Il s'agit de la limite du nombre de sessions de l'éditeur de requêtes pouvant se connecter à une base de données Amazon Redshift. Elle ne s'applique pas aux autres clients tels que les applications App Studio.

  5. Créez vos tableaux de données selon le public schéma. INSERTtoutes les données initiales dans ces tableaux.

  6. Exécutez les commandes suivantes dans l'éditeur de requêtes :

    La commande suivante crée un utilisateur de base de données et le connecte à un rôle IAM nommé AppBuilderDataAccessRole qui est utilisé par App Studio. Vous allez créer le rôle IAM lors d'une étape ultérieure, et le nom indiqué ici doit correspondre au nom attribué à ce rôle.

    CREATE USER "IAMR:AppBuilderDataAccessRole" WITH PASSWORD DISABLE;

    La commande suivante accorde toutes les autorisations sur toutes les tables à App Studio.

    Note

    Pour des pratiques de sécurité optimales, vous devez limiter les autorisations ici aux autorisations minimales requises dans les tableaux appropriés. Pour plus d'informations sur la GRANT commande, consultez GRANT dans le manuel Amazon Redshift Database Developer Guide.

    GRANT ALL ON ALL TABLES IN SCHEMA public to "IAMR:AppBuilderDataAccessRole";

Étape 2 : Création d'une politique et d'un rôle IAM avec les autorisations Amazon Redshift appropriées

Pour utiliser les ressources Amazon Redshift avec App Studio, les administrateurs doivent créer une politique et un rôle IAM pour autoriser App Studio à accéder aux ressources. La politique IAM contrôle l'étendue des données que les créateurs peuvent utiliser et les opérations qui peuvent être effectuées sur ces données, telles que Créer, Lire, Mettre à jour ou Supprimer. La politique IAM est ensuite associée à un rôle IAM utilisé par App Studio.

Nous vous recommandons de créer au moins un rôle IAM par service et par politique. Par exemple, si les créateurs créent deux applications soutenues par des tables différentes dans Amazon Redshift, un administrateur doit créer deux politiques et rôles IAM, un pour chacune des tables d'Amazon Redshift.

Étape 2a : créer une politique IAM avec les autorisations Amazon Redshift appropriées

La politique IAM que vous créez et utilisez avec App Studio ne doit contenir que les autorisations minimales nécessaires sur les ressources appropriées pour que l'application respecte les meilleures pratiques de sécurité.

Pour créer une politique IAM avec les autorisations Amazon Redshift appropriées
  1. Connectez-vous à la console IAM avec un utilisateur autorisé à créer des politiques IAM. Nous vous recommandons d'utiliser l'utilisateur administratif créé dansInscrivez-vous pour un Compte AWS.

  2. Dans le volet de navigation de gauche, choisissez Politiques.

  3. Choisissez Create Policy (Créer une politique).

  4. Dans la section Éditeur de politiques, choisissez l’option JSON.

  5. Tapez ou collez un document de politique JSON. Les onglets suivants contiennent des exemples de politiques pour Amazon Redshift provisionné et sans serveur.

    Note

    Les politiques suivantes s'appliquent à toutes les ressources Amazon Redshift utilisant le caractère générique ()*. Pour des raisons de sécurité optimales, vous devez remplacer le caractère générique par l'Amazon Resource Name (ARN) des ressources que vous souhaitez utiliser avec App Studio.

    Provisioned
    JSON
    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "ProvisionedRedshiftForAppStudio", "Effect": "Allow", "Action": [ "redshift:DescribeClusters", "redshift:GetClusterCredentialsWithIAM", "redshift-data:ListDatabases", "redshift-data:ListTables", "redshift-data:DescribeTable", "redshift-data:DescribeStatement", "redshift-data:ExecuteStatement", "redshift-data:GetStatementResult" ], "Resource": "*" } ] }
    Serverless
    JSON
    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "ServerlessRedshiftForAppStudio", "Effect": "Allow", "Action": [ "redshift-serverless:ListNamespaces", "redshift-serverless:GetCredentials", "redshift-serverless:ListWorkgroups", "redshift-data:ListDatabases", "redshift-data:ListTables", "redshift-data:DescribeTable", "redshift-data:DescribeStatement", "redshift-data:ExecuteStatement", "redshift-data:GetStatementResult" ], "Resource": "*" } ] }
  6. Choisissez Suivant.

  7. Sur la page Réviser et créer, indiquez un nom de politique, tel que RedshiftServerlessForAppStudio ouRedshiftProvisionedForAppStudio, et une description (facultatif).

  8. Choisissez Créer une politique pour créer la politique.

Étape 2b : créer un rôle IAM pour permettre à App Studio d'accéder aux ressources Amazon Redshift

À présent, créez un rôle IAM qui utilise la politique que vous avez créée précédemment. App Studio utilisera cette politique pour accéder aux ressources Amazon Redshift configurées.

Pour créer un rôle IAM permettant à App Studio d'accéder aux ressources Amazon Redshift
  1. Connectez-vous à la console IAM avec un utilisateur autorisé à créer des rôles IAM. Nous vous recommandons d'utiliser l'utilisateur administratif créé dansInscrivez-vous pour un Compte AWS.

  2. Dans le volet de navigation de gauche, choisissez Rôles

  3. Choisissez Créer un rôle.

  4. Dans Type d'entité de confiance, choisissez Politique de confiance personnalisée.

  5. Remplacez la politique par défaut par la politique suivante pour permettre aux applications App Studio d'assumer ce rôle dans votre compte.

    Vous devez remplacer les espaces réservés suivants dans la politique. Les valeurs à utiliser se trouvent dans App Studio, sur la page des paramètres du compte.

    • 111122223333Remplacez-le par le AWS numéro de compte du compte utilisé pour configurer l'instance App Studio, indiqué comme identifiant de AWS compte dans les paramètres du compte de votre instance App Studio.

    • Remplacez-le 11111111-2222-3333-4444-555555555555 par votre ID d'instance App Studio, répertorié comme ID d'instance dans les paramètres du compte de votre instance App Studio.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:PrincipalTag/IsAppStudioAccessRole": "true", "sts:ExternalId": "11111111-2222-3333-4444-555555555555" } } } ] }

    Choisissez Suivant.

  6. Dans Ajouter des autorisations, recherchez et sélectionnez la politique que vous avez créée à l'étape précédente (RedshiftServerlessForAppStudioouRedshiftProvisionedForAppStudio). Si vous cliquez sur le signe + à côté d'une politique, celle-ci sera étendue pour afficher les autorisations accordées par celle-ci, et si vous cochez la case, la stratégie sera sélectionnée.

    Choisissez Suivant.

  7. Sur la page Nom, révision et création, indiquez un nom et une description du rôle.

    Important

    Le nom du rôle ici doit correspondre au nom de rôle utilisé dans la GRANT commande in Étape 1 : Création et configuration des ressources Amazon Redshift (AppBuilderDataAccessRole).

  8. À l'étape 3 : Ajouter des balises, choisissez Ajouter une nouvelle étiquette pour ajouter la balise suivante afin de permettre l'accès à App Studio :

    • Clé : IsAppStudioDataAccessRole

    • Valeur : true

  9. Choisissez Créer un rôle et notez le nom de ressource Amazon (ARN) généré. Vous en aurez besoin lors de la création du connecteur Amazon Redshift dans App Studio.

Étape 3 : Création d'un connecteur Amazon Redshift

Maintenant que vos ressources Amazon Redshift, votre stratégie et votre rôle IAM sont configurés, utilisez ces informations pour créer le connecteur dans App Studio que les créateurs peuvent utiliser pour connecter leurs applications à Amazon Redshift.

Note

Vous devez avoir le rôle d'administrateur dans App Studio pour créer des connecteurs.

Pour créer un connecteur pour Amazon Redshift
  1. Accédez à App Studio.

  2. Dans le volet de navigation de gauche, choisissez Connectors dans la section Gérer. Vous serez redirigé vers une page affichant une liste des connecteurs existants avec quelques détails sur chacun d'eux.

  3. Choisissez + Créer un connecteur.

  4. Choisissez le connecteur Amazon Redshift.

  5. Configurez votre connecteur en remplissant les champs suivants :

    • Nom : donnez un nom à votre connecteur.

    • Description : Fournissez une description de votre connecteur.

    • Rôle IAM : entrez le nom de ressource Amazon (ARN) à partir du rôle IAM créé dans. Étape 2b : créer un rôle IAM pour permettre à App Studio d'accéder aux ressources Amazon Redshift Pour de plus amples informations sur IAM, consultez le Guide de l’utilisateur IAM.

    • Région : choisissez la AWS région dans laquelle se trouvent vos ressources Amazon Redshift.

    • Type de calcul : choisissez si vous utilisez Amazon Redshift Serverless ou un cluster provisionné.

    • Sélection d'un cluster ou d'un groupe de travail : si Provisioned est sélectionné, choisissez le cluster que vous souhaitez connecter à App Studio. Si vous choisissez Serverless, choisissez le groupe de travail.

    • Sélection de la base de données : choisissez la base de données que vous souhaitez connecter à App Studio.

    • Tableaux disponibles : sélectionnez les tableaux que vous souhaitez connecter à App Studio.

  6. Choisissez Suivant. Vérifiez les informations de connexion et choisissez Créer.

  7. Le connecteur nouvellement créé apparaîtra dans la liste des connecteurs.