Amazon Redshift ne prendra plus en charge l'utilisation des UDF Python après le 30 juin 2026. Nous allons commencer à l'appliquer par étapes. Pour plus d'informations sur les détails de la fin de vie de Python et des options de migration, consultez le billet de blog publié le 30 juin 2025.

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.

Interrogez les tables Amazon S3 depuis Amazon Redshift

Amazon Redshift s'intègre aux compartiments de tables Amazon S3, ce qui vous permet d'accéder aux ressources des tables S3 à l'aide d'Amazon Redshift. Que vous débutiez ou que vous gériez des milliers de tables dans votre environnement Iceberg, les compartiments de tables simplifient la gestion des lacs de données à toutes les échelles. Pour plus d’informations, consultez Table buckets.

Cette rubrique explique comment démarrer avec Amazon S3 Tables et Redshift et accéder aux objets S3 Tables à l'aide d'Amazon Redshift.

Conditions préalables

Avant d'interroger des tables S3 depuis Amazon Redshift, vous devez intégrer S3 Tables à. AWS Glue Data Catalog Pour obtenir des instructions, consultez la section Intégrer des tables Amazon S3 à AWS Glue Data Catalog.

Une fois que S3 Tables est intégré à AWS Glue Data Catalog, les administrateurs IAM disposant des tables S3 et des autorisations AWS Glue IAM requises peuvent découvrir les tables S3 via le. AWS Glue Data Catalog

Interrogez des tables S3 depuis Amazon Redshift

Pour commencer à interroger des tables S3, procédez comme suit :

Étape 1 : Création d'un rôle IAM pour Amazon Redshift

Votre cluster a besoin d'une autorisation pour accéder au catalogue externe de tables S3 dans AWS Glue. Pour fournir cette autorisation, Amazon Redshift utilise un rôle IAM associé à votre cluster. Créez un rôle IAM avec les autorisations de politique suivantes.

Pour créer une politique :

Pour créer un rôle IAM pour Amazon Redshift, procédez comme suit :

Étape 2 : associer un rôle IAM à votre cluster Amazon Redshift

Associez le rôle IAM que vous avez configuré à l'étape 1 à votre cluster Amazon Redshift.

À l'aide de la console AWS de gestion :

À l'aide de la AWS CLI :

Exécutez la commande suivante pour associer un rôle IAM à un cluster ou à un espace de noms existant. Remplacez my-redshift-cluster ou my-redshift-namespace par votre identifiant de cluster ou votre espace de noms et 111122223333 par votre identifiant de AWS compte.

aws redshift modify-cluster-iam-roles \
    --cluster-identifier my-redshift-cluster \
    --add-iam-roles arn:aws:iam::111122223333:role/RedshiftS3TablesRole

-- for serverless
aws redshift-serverless update-namespace \
    --namespace-name my-redshift-namespace \
    --iam-roles "arn:aws:iam::111122223333:role/RedshiftS3TablesRole"

Pour plus d’informations, consultez Association des rôles IAM aux clusters dans le Guide de gestion Amazon Redshift.

Étape 3 : Interrogez les tables S3 depuis Amazon Redshift

Lorsque vous intégrez S3 Tables à AWS Glue Data Catalog, le service crée une structure de catalogue fédérée qui fait correspondre les ressources des tables S3 aux objets du AWS Glue catalogue :

L'intégration crée la hiérarchie suivante :

Par exemple, si vous avez un compartiment de tables S3 nommé analytics-bucket avec un espace de noms sales contenant une tabletransactions, le chemin complet dans le AWS Glue Data Catalog serait :s3tablescatalog/analytics-bucket/sales/transactions.

Création d'un lien vers une ressource

Avant d'utiliser l'une des trois méthodes de requête ci-dessous, vous devez créer un lien vers une ressource dans AWS Glue Data Catalog. Les liens de ressources permettent à Amazon Redshift de référencer les bases de données S3 Tables via le catalogue standard.

À l'aide de AWS Glue la console :

À l'aide de la AWS CLI :

aws glue create-database \
  --region us-west-2 \
  --cli-input-json '{
        "CatalogId": "111122223333",
        "DatabaseInput": {
            "Name": "sales_resource_link",
            "TargetDatabase": {
                "CatalogId": "111122223333:s3tablescatalog/analytics-bucket",
                "DatabaseName": "sales"
            }
        }
  }'

Cette commande crée un lien de ressource nommé sales_resource_link dans votre catalogue de AWS Glue données par défaut qui pointe vers la sales base de données dans le compartiment de tables S3analytics-bucket.

Une fois les liens de ressources créés, Amazon Redshift propose trois méthodes pour interroger les tables S3. Choisissez la méthode qui convient le mieux à votre cas d'utilisation.

Méthode 1 : CRÉATION D'UN SCHÉMA EXTERNE

Permet CREATE EXTERNAL SCHEMA de créer un schéma externe qui fait référence à votre base de données S3 Tables. Cette méthode fournit un contrôle explicite sur la dénomination et la configuration des schémas.

Pour plus de détails sur la syntaxe, consultez la section CRÉER UN SCHÉMA EXTERNE dans le manuel Amazon Redshift Database Developer Guide.

Exemple

Utilisez le nom de la base de données et l'ID de catalogue indiqués à l'étape 3. 111122223333Remplacez-le par votre identifiant de AWS compte.

CREATE EXTERNAL SCHEMA s3tables_schema
FROM DATA CATALOG DATABASE 'sales_resource_link'
IAM_ROLE 'arn:aws:iam::111122223333:role/RedshiftS3TablesRole'
REGION 'us-west-2'
CATALOG_ID '111122223333';

SELECT * FROM s3tables_schema.transactions;

Méthode 2 : CRÉER UNE BASE DE DONNÉES À PARTIR DE L'ARN

Utilisez CREATE DATABASE FROM ARN cette clause pour créer une base de données fédérée qui fait directement référence à votre lien de AWS Glue ressource. Cette méthode mappe automatiquement la AWS Glue base de données à une base de données Redshift.

Pour plus de détails sur la syntaxe, consultez la section CRÉER UNE BASE DE DONNÉES dans le manuel Amazon Redshift Database Developer Guide.

Exemple

111122223333Remplacez-le par votre identifiant de AWS compte.

CREATE DATABASE s3tables_db
FROM ARN 'arn:aws:glue:us-west-2:111122223333:database/sales_resource_link'
WITH DATA CATALOG SCHEMA analytics_schema
IAM_ROLE 'arn:aws:iam::111122223333:role/RedshiftS3TablesRole';

SELECT * FROM s3tables_db.analytics_schema.transactions;

Méthode 3 : Auto-mounted awsdatacatalog

Amazon Redshift peut monter automatiquement des AWS Glue Data Catalog bases de données, y compris des liens vers des ressources S3 Tables, via la awsdatacatalog base de données. Cette méthode nécessite l'activation de l'accès fédéré à Spectrum (FAS) sur votre cluster.

Conditions préalables

Pour utiliser la base de awsdatacatalog données montée automatiquement, vous devez activer l'accès fédéré à Spectrum. Cela permet à Amazon Redshift d'utiliser des informations d'identification fédérées pour accéder à des sources de données externes AWS Glue Data Catalog et à des sources de données.

Pour activer l'accès fédéré à Spectrum, procédez comme suit :

Pour obtenir des instructions détaillées sur la configuration de l'accès fédéré, consultez la section Utilisation d'une identité fédérée pour gérer l'accès Amazon Redshift aux ressources locales et aux tables externes Amazon Redshift Spectrum dans le Amazon Redshift Management Guide.

Tables Query S3

Une fois l'accès fédéré configuré, vérifiez les schémas montés et interrogez vos tables S3.

Vérifiez les schémas montés :

SHOW SCHEMAS FROM DATABASE awsdatacatalog;

Interrogez les tables S3 à l'aide du nom du lien de ressource indiqué à l'étape 3 :

SELECT * FROM awsdatacatalog.sales_resource_link.transactions;