Rufen Sie Athena mit Step Functions auf

Step Functions kann bestimmte AWS Dienste direkt von Amazon States Language (ASL) aus steuern. Weitere Informationen hierzu finden Sie unter Arbeiten mit anderen -Services und Parameter an eine Service-API übergeben.

Wie sich die optimierte Athena-Integration von der Athena AWS SDK-Integration unterscheidet

• Das Ausführen einer Aufgabe (.sync) Integrationsmuster wird unterstützt.

• Es gibt keine Optimierungen für das Request Response (Antwort anfordern) Integrationsmuster.

• Das Warten auf einen Callback mit dem Aufgabentoken Integrationsmuster wird nicht unterstützt.

Die AWS Step Functions Serviceintegration mit Amazon Athena ermöglicht es Ihnen, Step Functions zu verwenden, um die Abfrageausführung zu starten und zu beenden und Abfrageergebnisse abzurufen. Mithilfe von Step Functions können Sie Ad-hoc-Datenabfragen oder geplante Datenabfragen ausführen und Ergebnisse abrufen, die auf Ihre S3-Datenseen abzielen. Athena ist Serverless, weshalb auch keine Infrastruktur eingerichtet oder verwaltet werden muss – und Sie zahlen nur für tatsächlich ausgeführte Abfragen.

Für die Integration AWS Step Functions mit Amazon Athena verwenden Sie die bereitgestellten Athena-Serviceintegrations-APIs.

Die Service-Integration-APIs sind dieselben wie die entsprechenden Athena-APIs. Nicht alle APIs unterstützen alle Integrationsmuster, wie in der folgenden Tabelle dargestellt wird:

API	Request Response (Antwort anfordern)	Ausführen einer Aufgabe (.sync)
StartQueryExecution	✓	✓
StopQueryExecution	✓
GetQueryExecution	✓
GetQueryResults	✓

Unterstützte Amazon Athena Athena-APIs:

Anmerkung

In Step Functions gibt es ein Kontingent für die maximale Eingabe- oder Ergebnisdatengröße für eine Aufgabe. Dadurch sind Sie auf 256 KB an Daten als UTF-8-kodierte Zeichenfolge beschränkt, wenn Sie Daten an einen anderen Dienst senden oder von einem anderen Dienst empfangen. Siehe Kontingente im Zusammenhang mit der Ausführung von Zustandsmaschinen.

• StartQueryExecution

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • ClientRequestToken

    • ExecutionParameters

    • QueryExecutionContext

    • QueryString

    • ResultConfiguration

    • WorkGroup

  • Response syntax

• StopQueryExecution

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • QueryExecutionId

• GetQueryExecution

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • QueryExecutionId

  • Response syntax

• GetQueryResults

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • MaxResults

    • NextToken

    • QueryExecutionId

  • Response syntax

Das Folgende beinhaltet einen Task-Status, der eine Athena-Abfrage startet.

"Start an Athena query": {
  "Type": "Task",
  "Resource": "arn:aws:states:::athena:startQueryExecution.sync",
  "Parameters": {
    "QueryString": "SELECT * FROM \"myDatabase\".\"myTable\" limit 1",
    "WorkGroup": "primary",
    "ResultConfiguration": {
       "OutputLocation": "s3://athenaQueryResult"
    }
  },
  "Next": "Get results of the query"
}

Informationen zur Konfiguration von IAM Berechtigungen bei der Verwendung Step Functions mit anderen AWS Diensten finden Sie unterIAM-Richtlinien für integrierte Dienste.