Connettore Amazon Athena AWS CMDB

Il connettore AWS CMDB per Amazon Athena consente ad Athena di comunicare con diversi servizi AWS in modo da poter eseguire query su di essi con SQL.

Prerequisiti

• Implementa il connettore sul tuo Account AWS utilizzando la console Athena o AWS Serverless Application Repository. Per ulteriori informazioni, consultare Distribuzione di un connettore origine dati o Utilizzo di AWS Serverless Application Repository per distribuire un connettore origine dati.

Parametri

Utilizza le variabili di ambiente Lambda illustrate in questa sezione per configurare il connettore AWS CMDB.

• 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 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 l'argomento relativo a PutObject nella Documentazione di riferimento dell'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.

• default_ec2_image_owner: (facoltativo) una volta impostato, controlla il proprietario predefinito dell'immagine Amazon EC2 che filtra le Amazon Machine Image (AMI). Se non imposti questo valore e la tua query sulla tabella delle immagini EC2 non include un filtro per il proprietario, i risultati includeranno tutte le immagini pubbliche.

Database e tabelle

Il connettore AWS CMDB per Amazon Athena rende disponibili i database e le tabelle seguenti per interrogare il tuo inventario delle risorse AWS. Per ulteriori informazioni sulle colonne disponibili in ogni tabella, esegui un'istruzione DESCRIBE database.table utilizzando la console o l'API Athena.

• ec2: questo database contiene risorse correlate ad Amazon EC2, tra cui le seguenti.

• ebs_volumes: contiene i dettagli dei tuoi volumi Amazon EBS.

• ec2_instances: contiene i dettagli delle tue istanze EC2.

• ec2_images: contiene i dettagli delle immagini delle tue istanze EC2.

• routing_tables: contiene i dettagli delle tue tabelle di instradamento del VPC.

• security_groups: contiene i dettagli dei tuoi gruppi di sicurezza.

• subnets: contiene i dettagli delle tue sottoreti VPC.

• vpcs: contiene i dettagli dei tuoi VPC.

• emr: questo database contiene risorse correlate ad Amazon EMR, tra cui le seguenti.

• emr_clusters: contiene i dettagli dei tuoi cluster EMR.

• rds: questo database contiene risorse correlate ad Amazon RDS, tra cui le seguenti.

• rds_instances: contiene i dettagli delle tue istanze RDS.

• s3: questo database contiene risorse correlate a RDS, tra cui le seguenti.

• bucket: contiene i dettagli dei tuoi bucket Amazon S3.

• objects: contiene i dettagli dei tuoi oggetti Amazon S3, escluso il loro contenuto.

Autorizzazioni richieste

Consulta la sezione Policies del file athena-aws-cmdb.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 interrompersi rapidamente con esito negativo quando la query a monte di Athena è terminata.

• S3 List: il connettore utilizza questa autorizzazione per elencare bucket e oggetti di Amazon S3.

• EC2 Describe: il connettore utilizza questa autorizzazione per descrivere risorse come le istanze Amazon EC2, i gruppi di sicurezza, i VPC e i volumi Amazon EBS.

• EMR Describe / List: il connettore utilizza questa autorizzazione per descrivere i cluster EMR.

• RDS Describe: il connettore utilizza questa autorizzazione per descrivere le istanze RDS.

Prestazioni

Attualmente, il connettore AWS CMDB per Athena non supporta le scansioni parallele. Il pushdown dei predicati viene eseguito all'interno della funzione Lambda. Ove possibile, i predicati parziali vengono inviati ai servizi interrogati. Ad esempio, una query per i dettagli di una specifica istanza Amazon EC2 chiama l'API EC2 con l'ID di istanza specifico per eseguire un'operazione descrittiva mirata.

Informazioni sulla licenza

Il progetto del connettore AWS CMDB per Amazon Athena è concesso in licenza ai sensi della Licenza Apache-2.0.

Consulta anche

Per ulteriori informazioni su questo connettore, visita il sito corrispondente su GitHub.com.