Registrazione delle query AWS Clean Rooms

La registrazione delle query è una funzionalità di. AWS Clean Rooms Quando crei una collaborazione e attivi la registrazione delle query, i membri possono archiviare i log delle query pertinenti in Amazon CloudWatch Logs.

Con i log delle query, i membri possono determinare se le query sono conformi alle regole di analisi e sono in linea con l'accordo di collaborazione. Inoltre, i log delle interrogazioni aiutano a supportare gli audit.

Quando l'opzione di registrazione delle query è attivata nella AWS Clean Rooms console, i log delle query includono quanto segue:

• analysisRule— La regola di analisi per la tabella configurata.

• analysisTemplateArn— Il modello di analisi che è stato eseguito (viene visualizzato in base alla regola di analisi).

• collaborationId— L'identificatore univoco per la collaborazione in cui è stata eseguita la query.

• configuredTableID— L'identificatore univoco per la tabella configurata a cui si fa riferimento nella query.

• directQueryAnalysisRulePolicy.custom.allowedAnalysis— Il modello di analisi consentito per l'esecuzione sulla tabella configurata (viene visualizzato in base alla regola di analisi).

• directQueryAnalysisRulePolicy.v1.custom.allowedAnalysisProviders— I provider di query autorizzati a creare query (viene visualizzato in base alla regola di analisi).

• eventID— L'identificatore univoco per l'esecuzione della query. Dopo il 31 agosto 2023, l'identificatore univoco è lo stesso del. protectedQueryID

• eventTimestamp— Il tempo di esecuzione della query.

• parameters.parametervalue— I valori dei parametri (visualizzati in base al testo dell'interrogazione).

• queryText— La definizione SQL dell'esecuzione della query. Se sono presenti parametri, vengono etichettati come:parametervalue.

• queryValidationErrors— Gli errori di interrogazione durante la convalida dell'interrogazione.

• schemaName— Il nome dell'associazione di tabelle configurata a cui si fa riferimento nella query.

Ricezione dei registri delle interrogazioni

Non è necessario eseguire alcuna azione al di fuori di AWS Clean Rooms per configurare i registri delle query. AWS Clean Rooms crea gruppi di log per le collaborazioni dopo che ogni membro della collaborazione ha creato un'iscrizione.

I membri che possono eseguire query, i membri che possono ricevere risultati e i membri le cui tabelle di configurazione sono referenziate nella query riceveranno un registro delle query.

Il membro che può eseguire query e il membro che può ricevere risultati riceveranno i log delle query per ogni tabella configurata a cui viene fatto riferimento nella query. Se non possiedono la tabella configurata, non saranno in grado di visualizzare l'ID della tabella configurata ()configuredTableID.

Se un membro ha più associazioni di tabelle configurate a cui fa riferimento la query, riceverà un registro delle query per ogni tabella configurata.

I log vengono creati per le query che contengono istruzioni SQL non supportate e supportate in. AWS Clean RoomsPer ulteriori dettagli, vedere SQL Reference.AWS Clean Rooms

I log vengono creati anche quando le query fanno riferimento a tabelle configurate che non sono associate alla collaborazione.

I log non vengono creati per un accesso SQL errato. AWS Clean Rooms

I log delle query non indicano che una query ha avuto esito positivo e che l'output della query è stato fornito. Confermano che una richiesta è stata inviata dal membro che può eseguire la query. I registri delle query confermano inoltre che la query contiene SQL supportato AWS Clean Rooms e fa riferimento alle tabelle configurate associate alla collaborazione.

Ad esempio, non viene prodotto un log se la query è stata annullata dopo averne AWS Clean Rooms convalidata la conformità alle regole di analisi e durante l'elaborazione della query.

Se si elimina il gruppo di log, è necessario ricrearlo manualmente con lo stesso nome del gruppo di log (ID di collaborazione della collaborazione). In alternativa, puoi disattivare e riattivare la registrazione nella tua iscrizione.

Per ulteriori informazioni su come attivare la registrazione delle query, consulta. Creazione di una collaborazione in AWS Clean Rooms

Per ulteriori informazioni su Amazon CloudWatch Logs, consulta la Amazon CloudWatch Logs User Guide.

Utilizzo dei log di interrogazione

Consigliamo ai membri di intraprendere periodicamente le seguenti azioni:

• Per verificare che le query corrispondano ai casi d'uso o alle query concordate per la collaborazione, esamina le query eseguite nella collaborazione.

  Per ulteriori informazioni su come visualizzare le interrogazioni recenti, vedere Visualizzazione delle interrogazioni recenti.

• Per verificare che le colonne della tabella configurate corrispondano a quanto concordato per la collaborazione, esamina le colonne della tabella configurate utilizzate nelle regole di analisi dei membri della collaborazione e nelle query.

  Per ulteriori informazioni su come visualizzare le colonne configurate, vedere Visualizzazione delle tabelle e delle regole di analisi.