Connecteur Amazon Athena pour Redis OSS

Déployez le connecteur sur votre Compte AWS à l’aide de la console Athena ou du AWS Serverless Application Repository. Pour plus d’informations, consultez Création d’une connexion à une source de données ou Utilisation d’AWS Serverless Application Repository pour déployer un connecteur de source de données.

Avant d’utiliser ce connecteur, configurez un VPC et un groupe de sécurité. Pour plus d’informations, consultez Création d’un VPC pour un connecteur de source de données ou une connexion AWS Glue.

spill_bucket – Spécifie le compartiment Amazon S3 pour les données qui dépassent les limites des fonctions Lambda.

spill_prefix – (Facultatif) Par défaut, il s’agit d’un sous-dossier dans le spill_bucket spécifié appelé athena-federation-spill. Nous vous recommandons de configurer un cycle de vie de stockage Amazon S3 à cet endroit pour supprimer les déversements supérieurs à un nombre de jours ou d’heures prédéterminé.

spill_put_request_headers – (Facultatif) Une carte codée au format JSON des en-têtes et des valeurs des demandes pour la demande putObject Amazon S3 utilisée pour le déversement (par exemple, {"x-amz-server-side-encryption" : "AES256"}). Pour les autres en-têtes possibles, veuillez consulter PutObject dans la Référence d’API Amazon Simple Storage Service.

kms_key_id – (Facultatif) Par défaut, toutes les données déversées vers Amazon S3 sont chiffrées à l'aide du mode de chiffrement authentifié AES-GCM et d'une clé générée de manière aléatoire. Pour que votre fonction Lambda utilise des clés de chiffrement plus puissantes générées par KMS, comme a7e63k4b-8loc-40db-a2a1-4d0en2cd8331, vous pouvez spécifier l’ID d’une clé KMS.

disable_spill_encryption – (Facultatif) Lorsque la valeur est définie sur True, le chiffrement des déversements est désactivé. La valeur par défaut est False afin que les données déversées vers S3 soient chiffrées à l’aide d’AES-GCM, soit à l’aide d’une clé générée de manière aléatoire soit à l’aide de KMS pour générer des clés. La désactivation du chiffrement des déversements peut améliorer les performances, surtout si votre lieu de déversement utilise le chiffrement côté serveur.

glue_catalog – (Facultatif) Utilisez cette option pour spécifier un catalogue AWS Glue entre compte. Par défaut, le connecteur tente d’obtenir des métadonnées depuis son propre compte AWS Glue.

redis-endpoint – (Obligatoire) nom d’hôte:port:mot de passe du serveur Redis OSS qui contient les données pour cette table (par exemple, athena-federation-demo.cache.amazonaws.com:6379). Vous pouvez également stocker le point de terminaison (ou une partie du point de terminaison) dans AWS Secrets Manager en utilisant ${Secret_Name} comme valeur de propriété de la table.

redis-keys-zset – (Obligatoire si redis-key-prefix n’est pas utilisé) Une liste de clés séparées par des virgules dont la valeur est a zset (par exemple, active-orders,pending-orders). Chacune des valeurs du zset est considérée comme une clé faisant partie de la table. La propriété redis-keys-zset ou redis-key-prefix doit être définie.

redis-key-prefix – (Obligatoire si redis-keys-zset n’est pas utilisé) Une liste de préfixes clés séparés par des virgules pour analyser des valeurs dans le tableau (par exemple, accounts-*,acct-). La propriété redis-key-prefix ou redis-keys-zset doit être définie.

redis-value-type – (Obligatoire) Définit la façon dont les valeurs des clés définies par redis-key-prefix ou redis-keys-zset sont mappés à votre table. Un littéral mappe à une seule colonne. Un zset mappe également à une seule colonne, mais chaque clé peut stocker de nombreuses lignes. Un hachage permet à chaque clé de constituer une ligne avec plusieurs colonnes (par exemple, un hachage, un littéral ou un zset).

redis-ssl-flag – (Facultatif) Quand la valeur est True, une connexion Redis qui utilise SSL/TLS est créée. La valeur par défaut est False.

redis-cluster-flag – (Facultatif) Quand la valeur est True, la prise en charge des instances Redis en cluster est autorisée. La valeur par défaut est False.

redis-db-number – (Facultatif) S’applique uniquement aux instances autonomes qui ne sont pas en cluster. Définissez ce nombre (par exemple 1, 2 ou 3) pour lire à partir d’une base de données Redis personnalisée. La base de données logique Redis par défaut est 0. Ce numéro ne fait pas référence à une base de données dans Athena ou AWS Glue, mais à une base de données logique Redis. Pour plus d’informations, consultez l’index SELECT dans la documentation Redis.

Chaîne

Hachage

Jeu trié (ZSet)

Amazon S3 write access (Accès en écriture Amazon S3) – Le connecteur nécessite un accès en écriture à un emplacement dans Amazon S3 pour déverser les résultats à partir de requêtes volumineuses.

Athena GetQueryExecution – Le connecteur utilise cette autorisation pour aboutir à un échec rapide lorsque la requête Athena en amont est terminée.

AWS Glue Data Catalog – Le connecteur Redis nécessite un accès en lecture seule au AWS Glue Data Catalog pour obtenir des informations sur le schéma.

CloudWatch Logs – Le connecteur nécessite un accès à CloudWatch Logs pour stocker les journaux.

Accès en lecture à AWS Secrets Manager— Si vous choisissez de stocker les détails du point de terminaison Redis dans Secrets Manager, vous devez autoriser le connecteur à accéder à ces secrets.

Accès VPC – Le connecteur nécessite la possibilité d’attacher des interfaces à votre VPC et de les détacher afin qu’il puisse s’y connecter et communiquer avec vos instances Redis.