Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Athena-Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Athena Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `batch-get-named-query`
Das folgende Codebeispiel zeigt, wie Sie`batch-get-named-query`.
**AWS CLI**
**So geben Sie Informationen zu mehr als einer Abfrage zurück**
Das folgende `batch-get-named-query` Beispiel gibt Informationen zu den benannten Abfragen zurück, die den angegebenen Wert haben IDs.
```
aws athena batch-get-named-query \
--named-query-ids a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 a1b2c3d4-5678-90ab-cdef-EXAMPLE33333
```
Ausgabe:
```
{
"NamedQueries": [
{
"Name": "Flights Select Query",
"Description": "Sample query to get the top 10 airports with the most number of departures since 2000",
"Database": "sampledb",
"QueryString": "SELECT origin, count(*) AS total_departures\nFROM\nflights_parquet\nWHERE year >= '2000'\nGROUP BY origin\nORDER BY total_departures DESC\nLIMIT 10;",
"NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"WorkGroup": "primary"
},
{
"Name": "Load flights table partitions",
"Description": "Sample query to load flights table partitions using MSCK REPAIR TABLE statement",
"Database": "sampledb",
"QueryString": "MSCK REPAIR TABLE flights_parquet;",
"NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"WorkGroup": "primary"
},
{
"Name": "CloudFront Select Query",
"Description": "Sample query to view requests per operating system during a particular time frame",
"Database": "sampledb",
"QueryString": "SELECT os, COUNT(*) count FROM cloudfront_logs WHERE date BETWEEN date '2014-07-05' AND date '2014-08-05' GROUP BY os;",
"NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"WorkGroup": "primary"
}
],
"UnprocessedNamedQueryIds": []
}
```
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [BatchGetNamedQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/batch-get-named-query.html)unter *AWS CLI Befehlsreferenz*.
### `batch-get-query-execution`
Das folgende Codebeispiel zeigt die Verwendung`batch-get-query-execution`.
**AWS CLI**
**So geben Sie Informationen zu einer oder mehreren Abfrageausführungen zurück**
Im folgenden `batch-get-query-execution` Beispiel werden Informationen zur Abfrageausführung für die Abfragen zurückgegeben, die die angegebene Abfrage haben IDs.
```
aws athena batch-get-query-execution \
--query-execution-ids a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 a1b2c3d4-5678-90ab-cdef-EXAMPLE22222
```
Ausgabe:
```
{
"QueryExecutions": [
{
"QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"Query": "create database if not exists webdata",
"StatementType": "DDL",
"ResultConfiguration": {
"OutputLocation": "s3://amzn-s3-demo-bucket/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.txt"
},
"QueryExecutionContext": {},
"Status": {
"State": "SUCCEEDED",
"SubmissionDateTime": 1593470720.592,
"CompletionDateTime": 1593470720.902
},
"Statistics": {
"EngineExecutionTimeInMillis": 232,
"DataScannedInBytes": 0,
"TotalExecutionTimeInMillis": 310,
"ResultConfiguration": {
"QueryQueueTimeInMillis": 50,
"ServiceProcessingTimeInMillis": 28
},
"WorkGroup": "AthenaAdmin"
},
{
"QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"Query": "select date, location, browser, uri, status from cloudfront_logs where method = 'GET' and status = 200 and location like 'SFO%' limit 10",
"StatementType": "DML",
"ResultConfiguration": {
"OutputLocation": "s3://amzn-s3-demo-bucket/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222.csv"
},
"QueryExecutionContext": {
"Database": "mydatabase",
"Catalog": "awsdatacatalog"
},
"Status": {
"State": "SUCCEEDED",
"SubmissionDateTime": 1593469842.665,
"CompletionDateTime": 1593469846.486
},
"Statistics": {
"EngineExecutionTimeInMillis": 3600,
"DataScannedInBytes": 203089,
"TotalExecutionTimeInMillis": 3821,
"QueryQueueTimeInMillis": 267,
"QueryPlanningTimeInMillis": 1175
},
"WorkGroup": "AthenaAdmin"
}
],
"UnprocessedQueryExecutionIds": []
}
```
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [BatchGetQueryExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/batch-get-query-execution.html)unter *AWS CLI Befehlsreferenz*.
### `create-data-catalog`
Das folgende Codebeispiel zeigt die Verwendung`create-data-catalog`.
**AWS CLI**
**So erstellen Sie einen Datenkatalog**
Im folgenden Beispiel für `create-data-catalog` wird der `dynamo_db_catalog`-Datenkatalog erstellt.
```
aws athena create-data-catalog \
--name dynamo_db_catalog \
--type LAMBDA \
--description "DynamoDB Catalog" \
--parameters function=arn:aws:lambda:us-west-2:111122223333:function:dynamo_db_lambda
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um das Ergebnis zu sehen, verwenden Sie `aws athena get-data-catalog --name dynamo_db_catalog`.
Weitere Informationen finden Sie unter [Registrierung eines Katalogs: create-data-catalog](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-registering-a-catalog) im *Amazon Athena Athena-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [CreateDataCatalog AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/create-data-catalog.html)*Befehlsreferenz.*
### `create-named-query`
Das folgende Codebeispiel zeigt die Verwendung`create-named-query`.
**AWS CLI**
**So erstellen Sie eine benannte Abfrage**
Im folgenden Beispiel für `create-named-query` wird eine gespeicherte Abfrage in der `AthenaAdmin`-Arbeitsgruppe erstellt, mit der die Tabelle `flights_parquet` nach Flügen von Seattle nach New York im Januar 2016 abgefragt wird, deren Abflug und Ankunft jeweils um mehr als zehn Minuten verspätet waren. Da es sich bei den Flughafencodewerten in der Tabelle um Zeichenfolgen handelt, die doppelte Anführungszeichen enthalten (z. B. „SEA“), werden sie durch umgekehrte Schrägstriche als Escape-Zeichen geschützt und von einfachen Anführungszeichen umgeben.
```
aws athena create-named-query \
--name "SEA to JFK delayed flights Jan 2016" \
--description "Both arrival and departure delayed more than 10 minutes." \
--database sampledb \
--query-string "SELECT flightdate, carrier, flightnum, origin, dest, depdelayminutes, arrdelayminutes FROM sampledb.flights_parquet WHERE yr = 2016 AND month = 1 AND origin = '\"SEA\"' AND dest = '\"JFK\"' AND depdelayminutes > 10 AND arrdelayminutes > 10" \
--work-group AthenaAdmin
```
Ausgabe:
```
{
"NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [CreateNamedQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/create-named-query.html)in der *AWS CLI Befehlsreferenz*.
### `create-work-group`
Das folgende Codebeispiel zeigt die Verwendung`create-work-group`.
**AWS CLI**
**So erstellen Sie eine Arbeitsgruppe**
Im folgenden Beispiel für `create-work-group` wird eine Arbeitsgruppe namens `Data_Analyst_Group` erstellt, die den Speicherort `s3://amzn-s3-demo-bucket` für die Ausgabe der Abfrageergebnisse nutzt. Mit dem Befehl wird eine Arbeitsgruppe erstellt, die die Clientkonfigurationseinstellungen außer Kraft setzt. Dazu gehört auch der Speicherort für die Ausgabe der Abfrageergebnisse. Der Befehl aktiviert außerdem CloudWatch Metriken und fügt der Arbeitsgruppe drei Schlüssel-Wert-Tag-Paare hinzu, um sie von anderen Arbeitsgruppen zu unterscheiden. Beachten Sie, dass das Argument `--configuration` keine Leerzeichen vor den Kommas enthält, die seine Optionen trennen.
```
aws athena create-work-group \
--name Data_Analyst_Group \
--configuration ResultConfiguration={OutputLocation="s3://amzn-s3-demo-bucket"},EnforceWorkGroupConfiguration="true",PublishCloudWatchMetricsEnabled="true" \
--description "Workgroup for data analysts" \
--tags Key=Division,Value=West Key=Location,Value=Seattle Key=Team,Value="Big Data"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um die Ergebnisse zu sehen, verwenden Sie `aws athena get-work-group --work-group Data_Analyst_Group`.
Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*.
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateWorkGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/create-work-group.html).AWS CLI *
### `delete-data-catalog`
Das folgende Codebeispiel zeigt die Verwendung`delete-data-catalog`.
**AWS CLI**
**So löschen Sie einen Datenkatalog**
Im folgenden Beispiel für `delete-data-catalog` wird der `UnusedDataCatalog`-Datenkatalog gelöscht.
```
aws athena delete-data-catalog \
--name UnusedDataCatalog
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Löschen eines Katalogs: delete-data-catalog](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-deleting-a-catalog) im *Amazon Athena Athena-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [DeleteDataCatalog AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/delete-data-catalog.html)*Befehlsreferenz.*
### `delete-named-query`
Das folgende Codebeispiel zeigt die Verwendung`delete-named-query`.
**AWS CLI**
**So löschen Sie eine benannte Abfrage**
Im folgenden Beispiel für `delete-named-query` wird die benannte Abfrage mit der angegebenen ID gelöscht.
```
aws athena delete-named-query \
--named-query-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [DeleteNamedQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/delete-named-query.html)in der *AWS CLI Befehlsreferenz*.
### `delete-work-group`
Das folgende Codebeispiel zeigt die Verwendung`delete-work-group`.
**AWS CLI**
**So löschen Sie eine Arbeitsgruppe**
Im folgenden Beispiel für `delete-work-group` wird die Arbeitsgruppe `TeamB` gelöscht.
```
aws athena delete-work-group \
--work-group TeamB
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um den Löschvorgang zu bestätigen, verwenden Sie `aws athena list-work-groups`.
Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [DeleteWorkGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/delete-work-group.html)in der *AWS CLI Befehlsreferenz*.
### `get-data-catalog`
Das folgende Codebeispiel zeigt die Verwendung`get-data-catalog`.
**AWS CLI**
**So rufen Sie Informationen über einen Datenkatalog ab**
Mit dem folgenden Beispiel für `get-data-catalog` werden Informationen über den `dynamo_db_catalog`-Datenkatalog zurückgegeben.
```
aws athena get-data-catalog \
--name dynamo_db_catalog
```
Ausgabe:
```
{
"DataCatalog": {
"Name": "dynamo_db_catalog",
"Description": "DynamoDB Catalog",
"Type": "LAMBDA",
"Parameters": {
"catalog": "dynamo_db_catalog",
"metadata-function": "arn:aws:lambda:us-west-2:111122223333:function:dynamo_db_lambda",
"record-function": "arn:aws:lambda:us-west-2:111122223333:function:dynamo_db_lambda"
}
}
}
```
Weitere Informationen finden Sie unter [Katalogdetails anzeigen: get-data-catalog](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-showing-details-of-a-catalog) im *Amazon Athena Athena-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetDataCatalog AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-data-catalog.html)*Befehlsreferenz.*
### `get-database`
Das folgende Codebeispiel zeigt die Verwendung`get-database`.
**AWS CLI**
**So rufen Sie Informationen über eine Datenbank in einem Datenkatalog ab**
Im folgenden Beispiel für `get-database` werden Informationen über die `sampledb`-Datenbank im `AwsDataCatalog`-Datenkatalog zurückgegeben.
```
aws athena get-database \
--catalog-name AwsDataCatalog \
--database-name sampledb
```
Ausgabe:
```
{
"Database": {
"Name": "sampledb",
"Description": "Sample database",
"Parameters": {
"CreatedBy": "Athena",
"EXTERNAL": "TRUE"
}
}
}
```
Weitere Informationen finden Sie unter [Anzeigen von Datenbankdetails: get-database](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-showing-details-of-a-database) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [GetDatabase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-database.html)in der *AWS CLI Befehlsreferenz*.
### `get-named-query`
Das folgende Codebeispiel zeigt die Verwendung`get-named-query`.
**AWS CLI**
**So geben Sie eine benannte Abfrage zurück**
Im folgenden Beispiel für `get-named-query` werden Informationen über die Abfrage mit der angegebenen ID zurückgegeben.
```
aws athena get-named-query \
--named-query-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"NamedQuery": {
"Name": "CloudFront Logs - SFO",
"Description": "Shows successful GET request data for SFO",
"Database": "default",
"QueryString": "select date, location, browser, uri, status from cloudfront_logs where method = 'GET' and status = 200 and location like 'SFO%' limit 10",
"NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"WorkGroup": "AthenaAdmin"
}
}
```
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [GetNamedQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-named-query.html)in der *AWS CLI Befehlsreferenz*.
### `get-query-execution`
Das folgende Codebeispiel zeigt die Verwendung`get-query-execution`.
**AWS CLI**
**So geben Sie Informationen über eine Abfrageausführung zurück**
Im folgenden Beispiel für `get-query-execution` werden Informationen über die Abfrage mit der angegebenen Abfrage-ID zurückgegeben.
```
aws athena get-query-execution \
--query-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"QueryExecution": {
"QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"Query": "select date, location, browser, uri, status from cloudfront_logs where method = 'GET
' and status = 200 and location like 'SFO%' limit 10",
"StatementType": "DML",
"ResultConfiguration": {
"OutputLocation": "s3://amzn-s3-demo-bucket/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.csv"
},
"QueryExecutionContext": {
"Database": "mydatabase",
"Catalog": "awsdatacatalog"
},
"Status": {
"State": "SUCCEEDED",
"SubmissionDateTime": 1593469842.665,
"CompletionDateTime": 1593469846.486
},
"Statistics": {
"EngineExecutionTimeInMillis": 3600,
"DataScannedInBytes": 203089,
"TotalExecutionTimeInMillis": 3821,
"QueryQueueTimeInMillis": 267,
"QueryPlanningTimeInMillis": 1175
},
"WorkGroup": "AthenaAdmin"
}
}
```
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [GetQueryExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-query-execution.html)in der *AWS CLI Befehlsreferenz*.
### `get-query-results`
Das folgende Codebeispiel zeigt die Verwendung`get-query-results`.
**AWS CLI**
**So geben Sie die Ergebnisse einer Abfrage zurück**
Im folgenden Beispiel für `get-query-results` werden die Ergebnisse der Abfrage mit der angegebenen Abfrage-ID zurückgegeben.
```
aws athena get-query-results \
--query-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"ResultSet": {
"Rows": [
{
"Data": [
{
"VarCharValue": "date"
},
{
"VarCharValue": "location"
},
{
"VarCharValue": "browser"
},
{
"VarCharValue": "uri"
},
{
"VarCharValue": "status"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "Safari"
},
{
"VarCharValue": "/test-image-2.jpeg"
},
{
"VarCharValue": "200"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "Opera"
},
{
"VarCharValue": "/test-image-2.jpeg"
},
{
"VarCharValue": "200"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "Firefox"
},
{
"VarCharValue": "/test-image-3.jpeg"
},
{
"VarCharValue": "200"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "Lynx"
},
{
"VarCharValue": "/test-image-3.jpeg"
},
{
"VarCharValue": "200"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "IE"
},
{
"VarCharValue": "/test-image-2.jpeg"
},
{
"VarCharValue": "200"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "Opera"
},
{
"VarCharValue": "/test-image-1.jpeg"
},
{
"VarCharValue": "200"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "Chrome"
},
{
"VarCharValue": "/test-image-3.jpeg"
},
{
"VarCharValue": "200"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "Firefox"
},
{
"VarCharValue": "/test-image-2.jpeg"
},
{
"VarCharValue": "200"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "Chrome"
},
{
"VarCharValue": "/test-image-3.jpeg"
},
{
"VarCharValue": "200"
}
]
},
{
"Data": [
{
"VarCharValue": "2014-07-05"
},
{
"VarCharValue": "SFO4"
},
{
"VarCharValue": "IE"
},
{
"VarCharValue": "/test-image-2.jpeg"
},
{
"VarCharValue": "200"
}
]
}
],
"ResultSetMetadata": {
"ColumnInfo": [
{
"CatalogName": "hive",
"SchemaName": "",
"TableName": "",
"Name": "date",
"Label": "date",
"Type": "date",
"Precision": 0,
"Scale": 0,
"Nullable": "UNKNOWN",
"CaseSensitive": false
},
{
"CatalogName": "hive",
"SchemaName": "",
"TableName": "",
"Name": "location",
"Label": "location",
"Type": "varchar",
"Precision": 2147483647,
"Data": [
"Scale": 0,
"Nullable": "UNKNOWN",
"CaseSensitive": true
},
{
"CatalogName": "hive",
"SchemaName": "",
"TableName": "",
"Name": "browser",
"Label": "browser",
"Type": "varchar",
"Precision": 2147483647,
"Scale": 0,
"Nullable": "UNKNOWN",
"CaseSensitive": true
},
{
"CatalogName": "hive",
"SchemaName": "",
"TableName": "",
"Name": "uri",
"Label": "uri",
"Type": "varchar",
"Precision": 2147483647,
"Scale": 0,
"Nullable": "UNKNOWN",
"CaseSensitive": true
},
{
"CatalogName": "hive",
"SchemaName": "",
"TableName": "",
"Name": "status",
"Label": "status",
"Type": "integer",
"Precision": 10,
"Scale": 0,
"Nullable": "UNKNOWN",
"CaseSensitive": false
}
]
}
},
"UpdateCount": 0
}
```
Weitere Informationen finden Sie unter [Arbeiten mit Abfrageergebnissen, Ausgabedateien und dem Abfrageverlauf](https://docs.aws.amazon.com/athena/latest/ug/querying.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [GetQueryResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-query-results.html)in der *AWS CLI Befehlsreferenz*.
### `get-table-metadata`
Das folgende Codebeispiel zeigt die Verwendung`get-table-metadata`.
**AWS CLI**
**So geben Sie Metadateninformationen über eine Tabelle zurück**
Im folgenden Beispiel für `get-table-metadata` werden Metadateninformationen über die Tabelle `counties`, einschließlich Spaltennamen und deren Datentypen, aus der `sampledb`-Datenbank des `AwsDataCatalog`-Datenkatalogs zurückgegeben.
```
aws athena get-table-metadata \
--catalog-name AwsDataCatalog \
--database-name sampledb \
--table-name counties
```
Ausgabe:
```
{
"TableMetadata": {
"Name": "counties",
"CreateTime": 1593559968.0,
"LastAccessTime": 0.0,
"TableType": "EXTERNAL_TABLE",
"Columns": [
{
"Name": "name",
"Type": "string",
"Comment": "from deserializer"
},
{
"Name": "boundaryshape",
"Type": "binary",
"Comment": "from deserializer"
},
{
"Name": "motto",
"Type": "string",
"Comment": "from deserializer"
},
{
"Name": "population",
"Type": "int",
"Comment": "from deserializer"
}
],
"PartitionKeys": [],
"Parameters": {
"EXTERNAL": "TRUE",
"inputformat": "com.esri.json.hadoop.EnclosedJsonInputFormat",
"location": "s3://amzn-s3-demo-bucket/json",
"outputformat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",
"serde.param.serialization.format": "1",
"serde.serialization.lib": "com.esri.hadoop.hive.serde.JsonSerde",
"transient_lastDdlTime": "1593559968"
}
}
}
```
Weitere Informationen finden Sie unter [Tabellendetails anzeigen: get-table-metadata](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-showing-details-of-a-table) im *Amazon Athena Athena-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetTableMetadata AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-table-metadata.html)*Befehlsreferenz.*
### `get-work-group`
Das folgende Codebeispiel zeigt die Verwendung`get-work-group`.
**AWS CLI**
**So geben Sie Informationen über eine Arbeitsgruppe zurück**
Im folgenden Beispiel für `get-work-group` werden Informationen über die `AthenaAdmin`-Arbeitsgruppe zurückgegeben.
```
aws athena get-work-group \
--work-group AthenaAdmin
```
Ausgabe:
```
{
"WorkGroup": {
"Name": "AthenaAdmin",
"State": "ENABLED",
"Configuration": {
"ResultConfiguration": {
"OutputLocation": "s3://amzn-s3-demo-bucket/"
},
"EnforceWorkGroupConfiguration": false,
"PublishCloudWatchMetricsEnabled": true,
"RequesterPaysEnabled": false
},
"Description": "Workgroup for Athena administrators",
"CreationTime": 1573677174.105
}
}
```
Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [GetWorkGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/get-work-group.html)in der *AWS CLI Befehlsreferenz*.
### `list-data-catalogs`
Das folgende Codebeispiel zeigt die Verwendung`list-data-catalogs`.
**AWS CLI**
**So listen Sie die bei Athena registrierten Datenkataloge auf**
Im folgenden Beispiel für `list-data-catalogs` werden die bei Athena registrierten Datenkataloge aufgelistet.
```
aws athena list-data-catalogs
```
Ausgabe:
```
{
"DataCatalogsSummary": [
{
"CatalogName": "AwsDataCatalog",
"Type": "GLUE"
},
{
"CatalogName": "cw_logs_catalog",
"Type": "LAMBDA"
},
{
"CatalogName": "cw_metrics_catalog",
"Type": "LAMBDA"
}
]
}
```
Weitere Informationen finden Sie unter [Auflisten registrierter Kataloge: list-data-catalogs](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-listing-registered-catalogs) im *Amazon Athena Athena-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListDataCatalogs AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-data-catalogs.html)*Befehlsreferenz*.
### `list-databases`
Das folgende Codebeispiel zeigt die Verwendung`list-databases`.
**AWS CLI**
**So listen Sie die Datenbanken in einem Datenkatalog auf**
Im folgenden Beispiel für `list-databases` werden die Datenbanken im `AwsDataCatalog`-Datenkatalog aufgelistet.
```
aws athena list-databases \
--catalog-name AwsDataCatalog
```
Ausgabe:
```
{
"DatabaseList": [
{
"Name": "default"
},
{
"Name": "mydatabase"
},
{
"Name": "newdb"
},
{
"Name": "sampledb",
"Description": "Sample database",
"Parameters": {
"CreatedBy": "Athena",
"EXTERNAL": "TRUE"
}
},
{
"Name": "webdata"
}
]
}
```
Weitere Informationen finden Sie unter [Auflisten von Datenbanken in einem Katalog: list-databases](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-listing-databases) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [ListDatabases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-databases.html)in der *AWS CLI Befehlsreferenz*.
### `list-named-queries`
Das folgende Codebeispiel zeigt die Verwendung`list-named-queries`.
**AWS CLI**
**So listen Sie die benannten Abfragen für eine Arbeitsgruppe auf**
Im folgenden Beispiel für `list-named-queries` werden die benannten Abfragen für die `AthenaAdmin`-Arbeitsgruppe aufgelistet.
```
aws athena list-named-queries \
--work-group AthenaAdmin
```
Ausgabe:
```
{
"NamedQueryIds": [
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE33333"
]
}
```
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [ListNamedQueries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-named-queries.html)in der *AWS CLI Befehlsreferenz*.
### `list-query-executions`
Das folgende Codebeispiel zeigt die Verwendung`list-query-executions`.
**AWS CLI**
**Um die Abfrage IDs der Abfragen in einer bestimmten Arbeitsgruppe aufzulisten**
Im folgenden `list-query-executions` Beispiel werden maximal zehn der Abfragen IDs in der `AthenaAdmin` Arbeitsgruppe aufgeführt.
```
aws athena list-query-executions \
--work-group AthenaAdmin \
--max-items 10
```
Ausgabe:
```
{
"QueryExecutionIds": [
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11110",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11114",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11115",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11116",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11117",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11118",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11119"
],
"NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0="
}
```
Weitere Informationen finden Sie unter [Arbeiten mit Abfrageergebnissen, Ausgabedateien und dem Abfrageverlauf](https://docs.aws.amazon.com/athena/latest/ug/querying.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [ListQueryExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-query-executions.html)in der *AWS CLI Befehlsreferenz.*
### `list-table-metadata`
Das folgende Codebeispiel zeigt die Verwendung`list-table-metadata`.
**AWS CLI**
**So listen Sie die Metadaten für Tabellen in der angegebenen Datenbank eines Datenkatalogs auf**
Im folgenden Beispiel für `list-table-metadata` werden Metadateninformationen für maximal zwei Tabellen in der `geography`-Datenbank des `AwsDataCatalog`-Datenkatalogs zurückgegeben.
```
aws athena list-table-metadata \
--catalog-name AwsDataCatalog \
--database-name geography \
--max-items 2
```
Ausgabe:
```
{
"TableMetadataList": [
{
"Name": "country_codes",
"CreateTime": 1586553454.0,
"TableType": "EXTERNAL_TABLE",
"Columns": [
{
"Name": "country",
"Type": "string",
"Comment": "geo id"
},
{
"Name": "alpha-2 code",
"Type": "string",
"Comment": "geo id2"
},
{
"Name": "alpha-3 code",
"Type": "string",
"Comment": "state name"
},
{
"Name": "numeric code",
"Type": "bigint",
"Comment": ""
},
{
"Name": "latitude",
"Type": "bigint",
"Comment": "location (latitude)"
},
{
"Name": "longitude",
"Type": "bigint",
"Comment": "location (longitude)"
}
],
"Parameters": {
"areColumnsQuoted": "false",
"classification": "csv",
"columnsOrdered": "true",
"delimiter": ",",
"has_encrypted_data": "false",
"inputformat": "org.apache.hadoop.mapred.TextInputFormat",
"location": "s3://amzn-s3-demo-bucket/csv/countrycode",
"outputformat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",
"serde.param.field.delim": ",",
"serde.serialization.lib": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe",
"skip.header.line.count": "1",
"typeOfData": "file"
}
},
{
"Name": "county_populations",
"CreateTime": 1586553446.0,
"TableType": "EXTERNAL_TABLE",
"Columns": [
{
"Name": "id",
"Type": "string",
"Comment": "geo id"
},
{
"Name": "country",
"Name": "id2",
"Type": "string",
"Comment": "geo id2"
},
{
"Name": "county",
"Type": "string",
"Comment": "county name"
},
{
"Name": "state",
"Type": "string",
"Comment": "state name"
},
{
"Name": "population estimate 2018",
"Type": "string",
"Comment": ""
}
],
"Parameters": {
"areColumnsQuoted": "false",
"classification": "csv",
"columnsOrdered": "true",
"delimiter": ",",
"has_encrypted_data": "false",
"inputformat": "org.apache.hadoop.mapred.TextInputFormat",
"location": "s3://amzn-s3-demo-bucket/csv/CountyPopulation",
"outputformat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",
"serde.param.field.delim": ",",
"serde.serialization.lib": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe",
"skip.header.line.count": "1",
"typeOfData": "file"
}
}
],
"NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ=="
}
```
Weitere Informationen finden Sie unter [Metadaten für alle Tabellen in einer Datenbank anzeigen: list-table-metadata](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-showing-all-table-metadata) im *Amazon Athena Athena-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListTableMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-table-metadata.html)in der *AWS CLI Befehlsreferenz.*
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**Beispiel 1: So listen Sie die Tags für eine Arbeitsgruppe auf**
Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für die Arbeitsgruppe `Data_Analyst_Group` aufgelistet:
```
aws athena list-tags-for-resource \
--resource-arn arn:aws:athena:us-west-2:111122223333:workgroup/Data_Analyst_Group
```
Ausgabe:
```
{
"Tags": [
{
"Key": "Division",
"Value": "West"
},
{
"Key": "Team",
"Value": "Big Data"
},
{
"Key": "Location",
"Value": "Seattle"
}
]
}
```
**Beispiel 2: So listen Sie die Tags für einen Datenkatalog auf**
Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für den `dynamo_db_catalog`-Datenkatalog aufgelistet.
```
aws athena list-tags-for-resource \
--resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog
```
Ausgabe:
```
{
"Tags": [
{
"Key": "Division",
"Value": "Mountain"
},
{
"Key": "Organization",
"Value": "Retail"
},
{
"Key": "Product_Line",
"Value": "Shoes"
},
{
"Key": "Location",
"Value": "Denver"
}
]
}
```
Weitere Informationen finden Sie unter [Auflisten der Tags für eine Ressource: list-tags-for-resource](https://docs.aws.amazon.com/athena/latest/ug/tags-operations.html#tags-operations-examples-cli-list-tags-for-resource) im *Amazon Athena Athena-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-tags-for-resource.html)*Befehlsreferenz.*
### `list-work-groups`
Das folgende Codebeispiel zeigt die Verwendung`list-work-groups`.
**AWS CLI**
**So listen Sie Arbeitsgruppen auf**
Im folgenden Beispiel für `list-work-groups` werden die Arbeitsgruppen im aktuellen Konto aufgelistet.
```
aws athena list-work-groups
```
Ausgabe:
```
{
"WorkGroups": [
{
"Name": "Data_Analyst_Group",
"State": "ENABLED",
"Description": "",
"CreationTime": 1578006683.016
},
{
"Name": "AthenaAdmin",
"State": "ENABLED",
"Description": "",
"CreationTime": 1573677174.105
},
{
"Name": "primary",
"State": "ENABLED",
"Description": "",
"CreationTime": 1567465222.723
}
]
}
```
Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [ListWorkGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/list-work-groups.html)in der *AWS CLI Befehlsreferenz*.
### `start-query-execution`
Das folgende Codebeispiel zeigt die Verwendung`start-query-execution`.
**AWS CLI**
**Beispiel 1: So führen Sie eine Abfrage in einer Arbeitsgruppe für die angegebene Tabelle in der angegebenen Datenbank und dem angegebenen Datenkatalog aus**
Im folgenden Beispiel für `start-query-execution` wird die `AthenaAdmin`-Arbeitsgruppe verwendet, um eine Abfrage für die `cloudfront_logs`-Tabelle in der `cflogsdatabase` im `AwsDataCatalog`-Datenkatalog auszuführen.
```
aws athena start-query-execution \
--query-string "select date, location, browser, uri, status from cloudfront_logs where method = 'GET' and status = 200 and location like 'SFO%' limit 10" \
--work-group "AthenaAdmin" \
--query-execution-context Database=cflogsdatabase,Catalog=AwsDataCatalog
```
Ausgabe:
```
{
"QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
**Beispiel 2: So führen Sie eine Abfrage aus, die eine angegebene Arbeitsgruppe verwendet, um eine Datenbank im angegebenen Datenkatalog zu erstellen**
Im folgenden Beispiel für `start-query-execution` wird die `AthenaAdmin`-Arbeitsgruppe verwendet, um die Datenbank `newdb` im Standarddatenkatalog `AwsDataCatalog` zu erstellen.
```
aws athena start-query-execution \
--query-string "create database if not exists newdb" \
--work-group "AthenaAdmin"
```
Ausgabe:
```
{
"QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11112"
}
```
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
**Beispiel 3: So führen Sie eine Abfrage aus, mit der eine Ansicht für eine Tabelle in der angegebenen Datenbank und dem angegebenen Datenkatalog erstellt wird**
Im folgenden Beispiel für `start-query-execution` wird eine `SELECT`-Anweisung für die `cloudfront_logs`-Tabelle in der `cflogsdatabase` verwendet, um die Ansicht `cf10` zu erstellen.
```
aws athena start-query-execution \
--query-string "CREATE OR REPLACE VIEW cf10 AS SELECT * FROM cloudfront_logs limit 10" \
--query-execution-context Database=cflogsdatabase
```
Ausgabe:
```
{
"QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11113"
}
```
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [StartQueryExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/start-query-execution.html)in der *AWS CLI Befehlsreferenz*.
### `stop-query-execution`
Das folgende Codebeispiel zeigt die Verwendung`stop-query-execution`.
**AWS CLI**
**So beenden Sie eine laufende Abfrage**
Im folgenden Beispiel für `stop-query-execution` wird die Abfrage mit der angegebenen Abfrage-ID beendet.
```
aws athena stop-query-execution \
--query-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Ausführen von SQL-Abfragen mit Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [StopQueryExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/stop-query-execution.html)in der *AWS CLI Befehlsreferenz*.
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-resource`.
**AWS CLI**
**So fügen Sie einer Ressource ein Tag hinzu**
Im folgenden Beispiel für `tag-resource` werden dem `dynamo_db_catalog`-Datenkatalog drei Tags hinzugefügt.
```
aws athena tag-resource \
--resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog \
--tags Key=Organization,Value=Retail Key=Division,Value=Mountain Key=Product_Line,Value=Shoes Key=Location,Value=Denver
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um das Ergebnis zu sehen, verwenden Sie `aws athena list-tags-for-resource --resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog`.
Weitere Informationen finden Sie unter [Auflisten der Tags für eine Ressource: tag-resource](https://docs.aws.amazon.com/athena/latest/ug/tags-operations.html#tags-operations-examples-cli-tag-resource) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/tag-resource.html)in der *AWS CLI Befehlsreferenz*.
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**So entfernen Sie ein Tag von einer Ressource**
Im folgenden Beispiel für `untag-resource` werden die Schlüssel `Specialization` und `Focus` sowie deren zugeordneten Werte aus der `dynamo_db_catalog`-Datenkatalogressource entfernt.
```
aws athena untag-resource \
--resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog \
--tag-keys Specialization Focus
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um die Ergebnisse anzuzeigen, verwenden Sie den `list-tags-for-resource`-Befehl.
Weitere Informationen finden Sie unter [Entfernen der Tags von einer Ressource: untag-resource](https://docs.aws.amazon.com/athena/latest/ug/tags-operations.html#tags-operations-examples-cli-untag-resource) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/untag-resource.html)in der *AWS CLI Befehlsreferenz*.
### `update-data-catalog`
Das folgende Codebeispiel zeigt die Verwendung`update-data-catalog`.
**AWS CLI**
**So aktualisieren Sie einen Datenkatalog**
Im folgenden Beispiel für `update-data-catalog` werden die Lambda-Funktion und die Beschreibung des `cw_logs_catalog`-Datenkatalogs aktualisiert.
```
aws athena update-data-catalog \
--name cw_logs_catalog \
--type LAMBDA \
--description "New CloudWatch Logs Catalog" \
--function=arn:aws:lambda:us-west-2:111122223333:function:new_cw_logs_lambda
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um das Ergebnis zu sehen, verwenden Sie `aws athena get-data-catalog --name cw_logs_catalog`.
Weitere Informationen finden Sie unter [Aktualisieren eines Katalogs: update-data-catalog](https://docs.aws.amazon.com/athena/latest/ug/datastores-hive-cli.html#datastores-hive-cli-updating-a-catalog) im *Amazon Athena Athena-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [UpdateDataCatalog AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/update-data-catalog.html)*Befehlsreferenz.*
### `update-work-group`
Das folgende Codebeispiel zeigt die Verwendung`update-work-group`.
**AWS CLI**
**So aktualisieren Sie eine Arbeitsgruppe**
Im folgenden Beispiel für `update-work-group` wird die Arbeitsgruppe `Data_Analyst_Group` deaktiviert. Benutzer können in der deaktivierten Arbeitsgruppe keine Abfragen ausführen oder erstellen, können aber dennoch Metriken, Limits zur Kontrolle der Datennutzung, Arbeitsgruppeneinstellungen, den Abfrageverlauf und gespeicherte Abfragen anzeigen.
```
aws athena update-work-group \
--work-group Data_Analyst_Group \
--state DISABLED
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben. Um die Statusänderung zu überprüfen, verwenden Sie `aws athena get-work-group --work-group Data_Analyst_Group` und überprüfen Sie die Eigenschaft `State` in der Ausgabe.
Weitere Informationen finden Sie unter [Verwalten von Arbeitsgruppen](https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-update-delete.html) im *Benutzerhandbuch für Amazon Athena*.
+ Einzelheiten zur API finden Sie [UpdateWorkGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/athena/update-work-group.html)in der *AWS CLI Befehlsreferenz*.