Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Connettore Amazon Athena Redis OSS Il connettore Amazon Athena Redis OSS consente ad Amazon Athena di comunicare con le istanze Redis OSS in modo da poter eseguire query sui dati Redis OSS con SQL. Puoi usare AWS Glue Data Catalog per mappare le coppie chiave-valore Redis OSS in tabelle virtuali. A differenza dei tradizionali archivi di dati relazionali, Redis OSS non ha il concetto di tabella o colonna. Al contrario, Redis OSS offre modelli di accesso chiave-valore in cui la chiave è essenzialmente una `string` e il valore è una `string`, un `z-set` oppure una `hmap`. È possibile utilizzare il AWS Glue Data Catalog per creare schemi e configurare tabelle virtuali. Le proprietà speciali della tabella indicano al connettore Redis OSS per Athena come mappare le chiavi e i valori di Redis OSS in una tabella. Per ulteriori informazioni, consultare [Configurazione di database e tabelle in AWS Glue](#connectors-redis-setting-up-databases-and-tables-in-glue) riportata di seguito in questo documento. Questo connettore non utilizza connessioni Glue per centralizzare le proprietà di configurazione in Glue. La configurazione della connessione viene effettuata tramite Lambda. Se hai abilitato Lake Formation nel tuo account, il ruolo IAM per il tuo connettore Lambda federato Athena che hai distribuito nell'accesso in lettura deve avere accesso in lettura in AWS Serverless Application Repository Lake Formation a. AWS Glue Data Catalog Il connettore Amazon Athena Redis OSS supporta Amazon MemoryDB e ElastiCache Amazon (Redis OSS). ## Prerequisiti + Implementa il connettore sul tuo Account AWS utilizzando la console Athena o AWS Serverless Application Repository. Per ulteriori informazioni, consulta [Crea una connessione di un'origine dati](connect-to-a-data-source.md) o [Utilizzare il AWS Serverless Application Repository per distribuire un connettore di origine dati](connect-data-source-serverless-app-repo.md). + Prima di utilizzare questo connettore, configura un VPC e un gruppo di sicurezza. Per ulteriori informazioni, consulta [Crea un VPC per un connettore o una connessione di origine dati AWS Glue](athena-connectors-vpc-creation.md). ## Parameters Utilizzare i parametri illustrati in questa sezione per configurare il connettore Redis. ### Connettori federati del catalogo dati Athena + **spill\_bucket**: specifica il bucket Amazon S3 per i dati che superano i limiti della funzione Lambda. + **spill\_prefix**: (facoltativo) per impostazione predefinita, viene utilizzata una sottocartella nello `spill_bucket` specificato chiamata `athena-federation-spill`. Ti consigliamo di configurare un [ciclo di vita dell'archiviazione](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) di Amazon S3 in questa posizione per eliminare gli spill più vecchi di un numero predeterminato di giorni o ore. + **spill\_put\_request\_headers**: (facoltativo) una mappa codificata in JSON delle intestazioni e dei valori della richiesta per la richiesta `putObject` di Amazon S3 utilizzata per lo spill (ad esempio, `{"x-amz-server-side-encryption" : "AES256"}`). Per altre possibili intestazioni, consulta il *riferimento [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)all'API di Amazon Simple Storage Service*. + **kms\_key\_id**: (facoltativo) per impostazione predefinita, tutti i dati riversati in Amazon S3 vengono crittografati utilizzando la modalità di crittografia autenticata AES-GCM e una chiave generata casualmente. Per fare in modo che la tua funzione Lambda utilizzi chiavi di crittografia più potenti generate da KMS come `a7e63k4b-8loc-40db-a2a1-4d0en2cd8331`, puoi specificare l'ID della chiave KMS. + **disable\_spill\_encryption**: (facoltativo) se impostato su `True`, disabilita la crittografia dello spill. L'impostazione predefinita è `False`: in questo modo, i dati riversati su S3 vengono crittografati utilizzando AES-GCM tramite una chiave generata casualmente o una chiave generata mediante KMS. La disabilitazione della crittografia dello spill può migliorare le prestazioni, soprattutto se la posizione dello spill utilizza la [crittografia lato server](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html). + **glue\_catalog**: (facoltativo) utilizza questa opzione per specificare un [catalogo AWS Glue multi-account](data-sources-glue-cross-account.md). Per impostazione predefinita, il connettore tenta di ottenere metadati dal proprio account. AWS Glue ## Configurazione di database e tabelle in AWS Glue Per abilitare una AWS Glue tabella da utilizzare con Redis OSS, è possibile impostare le seguenti proprietà della tabella: `redis-endpoint``redis-value-type`, e `redis-keys-zset` o`redis-key-prefix`. Inoltre, qualsiasi AWS Glue database che contiene tabelle Redis OSS deve avere una `redis-db-flag` proprietà URI del database. Per impostare la proprietà `redis-db-flag` URI, usa la AWS Glue console per modificare il database. L'elenco seguente descrive le proprietà delle tabelle. + **redis-endpoint** — (Obbligatorio) Il {{hostname}} `:` {{port}} `:` {{password}} server Redis OSS che contiene i dati per questa tabella (ad esempio,`athena-federation-demo.cache.amazonaws.com:6379`) In alternativa, puoi memorizzare l'endpoint, o parte dell'endpoint, Gestione dei segreti AWS utilizzando $ {} {{Secret\_Name}} come valore della proprietà della tabella. **Nota** [Per utilizzare la funzionalità Athena Federated Query con, Gestione dei segreti AWS il VPC collegato alla funzione Lambda deve avere [accesso a Internet o](https://aws.amazon.com/premiumsupport/knowledge-center/internet-access-lambda-function/) un endpoint VPC per connettersi a Secrets Manager.](https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html) + **redis-keys-zset**[— (Obbligatorio se non `redis-key-prefix` viene utilizzato) Un elenco di chiavi separate da virgole il cui valore è un set (ad esempio,).](https://redis.com/ebook/part-2-core-concepts/chapter-3-commands-in-redis/3-5-sorted-sets/) `active-orders,pending-orders` Ciascuno dei valori del set viene considerato come una chiave facente parte della tabella. È necessario impostare la proprietà `redis-keys-zset` o la proprietà `redis-key-prefix`. + **redis-key-prefix**— (Obbligatorio se non `redis-keys-zset` viene utilizzato) Un elenco separato da virgole di prefissi chiave per la scansione dei valori nella tabella (ad esempio,). `accounts-*,acct-` È necessario impostare la proprietà `redis-key-prefix` o la proprietà `redis-keys-zset`. + **redis-value-type**— (Obbligatorio) Definisce in che modo i valori delle chiavi definite da uno `redis-key-prefix` o dall'altro `redis-keys-zset` vengono mappati sulla tabella. Un valore letterale è associato a una singola colonna. Anche un zset è associato a una singola colonna, ma ogni chiave può archiviare più righe. Un hash consente a ciascuna chiave di costituire una riga con più colonne (ad esempio, hash, letterale o zset). + **redis-ssl-flag**— (Facoltativo) Quando`True`, crea una connessione Redis che utilizza SSL/TLS. Il valore predefinito è `False`. + **redis-cluster-flag**— (Facoltativo) Quando`True`, abilita il supporto per le istanze Redis in cluster. Il valore predefinito è `False`. + **redis-db-number**— (Facoltativo) Si applica solo alle istanze autonome e non raggruppate.) Imposta questo numero (ad esempio 1, 2 o 3) per leggere da un database Redis non predefinito. L'impostazione predefinita è il database logico Redis 0. Questo numero non si riferisce a un database in Athena o AWS Glue, ma a un database logico Redis. Per ulteriori informazioni, consulta la sezione [SELECT index](https://redis.io/commands/select) (Indice SELECT) nella documentazione di Redis. ## Tipi di dati Il connettore Redis OSS supporta i seguenti tipi di dati. I flussi Redis OSS non sono supportati. + [Stringa](https://redis.com/ebook/part-1-getting-started/chapter-1-getting-to-know-redis/1-2-what-redis-data-structures-look-like/1-2-1-strings-in-redis/) + [Hash](https://redis.com/ebook/part-1-getting-started/chapter-1-getting-to-know-redis/1-2-what-redis-data-structures-look-like/1-2-4-hashes-in-redis/) + Set ordinato () [ZSet](https://redis.com/ebook/part-2-core-concepts/chapter-3-commands-in-redis/3-5-sorted-sets/) Tutti i valori di Redis OSS vengono recuperati come tipo di dati `string`. Quindi vengono convertiti in uno dei seguenti tipi di dati Apache Arrow in base a come sono state definite le tabelle nel AWS Glue Data Catalog. **** | AWS Glue tipo di dati | Tipo di dati Apache Arrow | | --- | --- | | int | INT | | stringa | VARCHAR | | bigint | BIGINT | | virgola mobile a doppia precisione | FLOAT8 | | virgola mobile | FLOAT4 | | smallint | SMALLINT | | tinyint | TINYINT | | booleano | BIT | | binary | VARBINARY | ## Autorizzazioni richieste Consulta la sezione `Policies` del file [athena-redis.yaml](https://github.com/awslabs/aws-athena-query-federation/blob/master/athena-redis/athena-redis.yaml) per i dettagli completi delle policy IAM richieste da questo connettore. L'elenco che segue riporta un riepilogo delle autorizzazioni richieste. + **Accesso in scrittura ad Amazon S3**: per trasferire i risultati di query di grandi dimensioni, il connettore richiede l'accesso in scrittura a una posizione in Amazon S3. + **Athena GetQueryExecution**: il connettore utilizza questa autorizzazione per fallire rapidamente quando la query Athena upstream è terminata. + **AWS Glue Data Catalog**— Il connettore Redis richiede l'accesso in sola lettura a per ottenere informazioni sullo schema. AWS Glue Data Catalog + **CloudWatch Registri**: il connettore richiede l'accesso ai CloudWatch registri per l'archiviazione dei registri. + **Gestione dei segreti AWS accesso in lettura**: se scegli di archiviare i dettagli degli endpoint Redis in Secrets Manager, devi concedere al connettore l'accesso a tali segreti. + **Accesso VPC**: il connettore richiede la capacità di collegare e scollegare le interfacce al VPC in modo che possa connettersi ad esso e comunicare con le istanze Redis. ## Performance Il connettore Redis OSS per Athena tenta di eseguire in parallelo le query sull’istanza Redis OSS in base al tipo di tabella che hai definito (ad esempio, chiavi zset chiavi di prefisso). Il connettore Athena Redis esegue il pushdown del predicato per ridurre la quantità di dati scansionati dalla query. Tuttavia, le query contenenti un predicato sulla chiave primaria comportano un errore di timeout. Le clausole `LIMIT` riducono la quantità di dati scansionati, ma se non viene fornito un predicato, le query `SELECT` con una clausola `LIMIT` eseguiranno la scansione di almeno 16 MB di dati. Il connettore Redis è resiliente alla limitazione della larghezza di banda della rete dovuta alla simultaneità. ## Query passthrough Il connettore Redis supporta le [query passthrough](federated-query-passthrough.md). È possibile utilizzare questa funzionalità per eseguire query che utilizzano lo script Lua sui database Redis. Per creare query passthrough con Redis, utilizzare la seguente sintassi: ``` SELECT * FROM TABLE( system.script( script => 'return redis.[call|pcall]({{query_script}})', keys => '[{{key_pattern}}]', argv => '[{{script_arguments}}]' )) ``` L’esempio seguente esegue uno script Lua per ottenere il valore in chiave `l:a`. ``` SELECT * FROM TABLE( system.script( script => 'return redis.call("GET", KEYS[1])', keys => '[l:a]', argv => '[]' )) ``` ## Informazioni sulla licenza Il progetto del connettore Redis per Amazon Athena è concesso in licenza ai sensi della [Licenza Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0.html). ## Risorse aggiuntive Per ulteriori informazioni su questo connettore, visitate [il sito corrispondente su GitHub .com](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-redis).