Athena contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Athena contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface with Athena.

Tindakan adalah kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanbatch-get-named-query.

AWS CLI

Untuk mengembalikan informasi tentang lebih dari satu kueri

batch-get-named-queryContoh berikut mengembalikan informasi tentang query bernama yang telah ditentukanIDs.

aws athena batch-get-named-query \
    --named-query-ids a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 a1b2c3d4-5678-90ab-cdef-EXAMPLE33333

Output:

{
    "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": []
}

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanbatch-get-query-execution.

AWS CLI

Untuk mengembalikan informasi tentang satu atau lebih eksekusi kueri

batch-get-query-executionContoh berikut mengembalikan informasi eksekusi query untuk query yang memiliki query IDs tertentu.

aws athena batch-get-query-execution \
    --query-execution-ids a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 a1b2c3d4-5678-90ab-cdef-EXAMPLE22222

Output:

{
    "QueryExecutions": [
        {
            "QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "Query": "create database if not exists webdata",
            "StatementType": "DDL",
            "ResultConfiguration": {
                "OutputLocation": "s3://awsdoc-example-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://awsdoc-example-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": []
}

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakancreate-data-catalog.

AWS CLI

Untuk membuat katalog data

create-data-catalogContoh berikut membuat katalog dynamo_db_catalog data.

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

Perintah ini tidak menghasilkan output. Untuk melihat hasilnya, gunakanaws athena get-data-catalog --name dynamo_db_catalog.

Untuk informasi selengkapnya, lihat Mendaftarkan Katalog: create-data-catalog di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakancreate-named-query.

AWS CLI

Untuk membuat kueri bernama

create-named-queryContoh berikut membuat kueri tersimpan di AthenaAdmin workgroup yang menanyakan flights_parquet tabel untuk penerbangan dari Seattle ke New York pada bulan Januari 2016 yang keberangkatan dan kedatangannya ditunda lebih dari sepuluh menit. Karena nilai kode bandara dalam tabel adalah string yang menyertakan tanda kutip ganda (misalnya, "SEA“), nilai tersebut diloloskan oleh garis miring terbalik dan dikelilingi oleh tanda kutip tunggal.

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

Output:

{
    "NamedQueryId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakancreate-work-group.

AWS CLI

Untuk membuat workgroup

create-work-groupContoh berikut membuat workgroup yang disebut Data_Analyst_Group yang memiliki lokasi s3://awsdoc-example-bucket output hasil query. Perintah membuat workgroup yang mengesampingkan pengaturan konfigurasi klien, yang mencakup lokasi keluaran hasil kueri. Perintah ini juga memungkinkan CloudWatch metrik dan menambahkan tiga pasangan tag nilai kunci ke workgroup untuk membedakannya dari kelompok kerja lainnya. Perhatikan bahwa --configuration argumen tidak memiliki spasi sebelum koma yang memisahkan opsinya.

aws athena create-work-group \
    --name Data_Analyst_Group \
    --configuration ResultConfiguration={OutputLocation="s3://awsdoc-example-bucket"},EnforceWorkGroupConfiguration="true",PublishCloudWatchMetricsEnabled="true" \
    --description "Workgroup for data analysts" \
    --tags Key=Division,Value=West Key=Location,Value=Seattle Key=Team,Value="Big Data"

Perintah ini tidak menghasilkan output. Untuk melihat hasilnya, gunakanaws athena get-work-group --work-group Data_Analyst_Group.

Untuk informasi selengkapnya, lihat Mengelola Grup Kerja di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakandelete-data-catalog.

AWS CLI

Untuk menghapus katalog data

delete-data-catalogContoh berikut menghapus katalog UnusedDataCatalog data.

aws athena delete-data-catalog \
    --name UnusedDataCatalog

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menghapus Katalog: delete-data-catalog di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakandelete-named-query.

AWS CLI

Untuk menghapus kueri bernama

delete-named-queryContoh berikut menghapus query bernama yang memiliki ID tertentu.

aws athena delete-named-query \
    --named-query-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakandelete-work-group.

AWS CLI

Untuk menghapus workgroup

delete-work-groupContoh berikut menghapus TeamB workgroup.

aws athena delete-work-group \
    --work-group TeamB

Perintah ini tidak menghasilkan output. Untuk mengkonfirmasi penghapusan, gunakan. aws athena list-work-groups

Untuk informasi selengkapnya, lihat Mengelola Grup Kerja di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanget-data-catalog.

AWS CLI

Untuk mengembalikan informasi tentang katalog data

get-data-catalogContoh berikut mengembalikan informasi tentang katalog dynamo_db_catalog data.

aws athena get-data-catalog \
    --name dynamo_db_catalog

Output:

{
    "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"
        }
    }
}

Untuk informasi selengkapnya, lihat Menampilkan Detail Katalog: get-data-catalog di Panduan Pengguna Amazon Athena.

  • Untuk API detailnya, lihat GetDataCatalogdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-database.

AWS CLI

Untuk mengembalikan informasi tentang database dalam katalog data

get-databaseContoh berikut mengembalikan informasi tentang sampledb database dalam katalog AwsDataCatalog data.

aws athena get-database \
    --catalog-name AwsDataCatalog \
    --database-name sampledb

Output:

{
    "Database": {
        "Name": "sampledb",
        "Description": "Sample database",
        "Parameters": {
            "CreatedBy": "Athena",
            "EXTERNAL": "TRUE"
        }
    }
}

Untuk informasi selengkapnya, lihat Menampilkan Detail Database: get-database di Panduan Pengguna Amazon Athena.

  • Untuk API detailnya, lihat GetDatabasedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-named-query.

AWS CLI

Untuk mengembalikan kueri bernama

get-named-queryContoh berikut mengembalikan informasi tentang query yang memiliki ID tertentu.

aws athena get-named-query \
    --named-query-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Output:

{
    "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"
    }
}

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

  • Untuk API detailnya, lihat GetNamedQuerydi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-query-execution.

AWS CLI

Untuk mengembalikan informasi tentang eksekusi kueri

get-query-executionContoh berikut mengembalikan informasi tentang query yang memiliki ID query tertentu.

aws athena get-query-execution \
    --query-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Output:

{
    "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://awsdoc-example-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"
    }
}

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanget-query-results.

AWS CLI

Untuk mengembalikan hasil kueri

get-query-resultsContoh berikut mengembalikan hasil query yang memiliki ID query tertentu.

aws athena get-query-results \
    --query-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Output:

{
    "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
}

Untuk informasi selengkapnya, lihat Bekerja dengan Hasil Kueri, File Output, dan Riwayat Kueri di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanget-table-metadata.

AWS CLI

Untuk mengembalikan informasi metadata tentang tabel

get-table-metadataContoh berikut mengembalikan informasi metadata tentang counties tabel, termasuk termasuk nama kolom dan tipe datanya, dari sampledb database katalog data. AwsDataCatalog

aws athena get-table-metadata \
    --catalog-name AwsDataCatalog \
    --database-name sampledb \
    --table-name counties

Output:

{
    "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://awsdoc-example-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"
        }
    }
}

Untuk informasi selengkapnya, lihat Menampilkan Detail Tabel: get-table-metadata di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanget-work-group.

AWS CLI

Untuk mengembalikan informasi tentang workgroup

get-work-groupContoh berikut mengembalikan informasi tentang AthenaAdmin workgroup.

aws athena get-work-group \
    --work-group AthenaAdmin

Output:

{
    "WorkGroup": {
        "Name": "AthenaAdmin",
        "State": "ENABLED",
        "Configuration": {
            "ResultConfiguration": {
                "OutputLocation": "s3://awsdoc-example-bucket/"
            },
            "EnforceWorkGroupConfiguration": false,
            "PublishCloudWatchMetricsEnabled": true,
            "RequesterPaysEnabled": false
        },
        "Description": "Workgroup for Athena administrators",
        "CreationTime": 1573677174.105
    }
}

Untuk informasi selengkapnya, lihat Mengelola Grup Kerja di Panduan Pengguna Amazon Athena.

  • Untuk API detailnya, lihat GetWorkGroupdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-data-catalogs.

AWS CLI

Untuk membuat daftar katalog data yang terdaftar di Athena

list-data-catalogsContoh berikut mencantumkan katalog data yang terdaftar di Athena.

aws athena list-data-catalogs

Output:

{
    "DataCatalogsSummary": [
        {
            "CatalogName": "AwsDataCatalog",
            "Type": "GLUE"
        },
        {
            "CatalogName": "cw_logs_catalog",
            "Type": "LAMBDA"
        },
        {
            "CatalogName": "cw_metrics_catalog",
            "Type": "LAMBDA"
        }
    ]
}

Untuk informasi selengkapnya, lihat Daftar Katalog Terdaftar: list-data-catalogs di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanlist-databases.

AWS CLI

Untuk membuat daftar database dalam katalog data

list-databasesContoh berikut mencantumkan database dalam katalog AwsDataCatalog data.

aws athena list-databases \
    --catalog-name AwsDataCatalog

Output:

{
    "DatabaseList": [
        {
            "Name": "default"
        },
        {
            "Name": "mydatabase"
        },
        {
            "Name": "newdb"
        },
        {
            "Name": "sampledb",
            "Description": "Sample database",
            "Parameters": {
                "CreatedBy": "Athena",
                "EXTERNAL": "TRUE"
            }
        },
        {
            "Name": "webdata"
        }
    ]
}

Untuk informasi selengkapnya, lihat Daftar Database dalam Katalog: daftar-database di Panduan Pengguna Amazon Athena.

  • Untuk API detailnya, lihat ListDatabasesdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-named-queries.

AWS CLI

Untuk mencantumkan kueri bernama untuk grup kerja

list-named-queriesContoh berikut mencantumkan kueri bernama untuk AthenaAdmin workgroup.

aws athena list-named-queries \
    --work-group AthenaAdmin

Output:

{
    "NamedQueryIds": [
        "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333"
    ]
}

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanlist-query-executions.

AWS CLI

Untuk membuat daftar kueri IDs dari kueri dalam workgroup tertentu

list-query-executionsContoh berikut mencantumkan maksimal sepuluh query IDs dalam AthenaAdmin workgroup.

aws athena list-query-executions \
    --work-group AthenaAdmin \
    --max-items 10

Output:

{
    "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="
}

Untuk informasi selengkapnya, lihat Bekerja dengan Hasil Kueri, File Output, dan Riwayat Kueri di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanlist-table-metadata.

AWS CLI

Untuk daftar metadata untuk tabel dalam database yang ditentukan dari katalog data

list-table-metadataContoh berikut mengembalikan informasi metadata untuk maksimal dua tabel dalam geography database katalog AwsDataCatalog data.

aws athena list-table-metadata \
    --catalog-name AwsDataCatalog \
    --database-name geography \
    --max-items 2

Output:

{
    "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://awsdoc-example-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://awsdoc-example-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=="
}

Untuk informasi selengkapnya, lihat Menampilkan Metadata untuk Semua Tabel dalam Database: list-table-metadata di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Contoh 1: Untuk daftar tag untuk workgroup

list-tags-for-resourceContoh berikut mencantumkan tag untuk Data_Analyst_Group workgroup.

aws athena list-tags-for-resource \
    --resource-arn arn:aws:athena:us-west-2:111122223333:workgroup/Data_Analyst_Group

Output:

{
    "Tags": [
        {
            "Key": "Division",
            "Value": "West"
        },
        {
            "Key": "Team",
            "Value": "Big Data"
        },
        {
            "Key": "Location",
            "Value": "Seattle"
        }
    ]
}

Contoh 2: Untuk daftar tag untuk katalog data

list-tags-for-resourceContoh berikut mencantumkan tag untuk katalog dynamo_db_catalog data.

aws athena list-tags-for-resource \
    --resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog

Output:

{
    "Tags": [
        {
            "Key": "Division",
            "Value": "Mountain"
        },
        {
            "Key": "Organization",
            "Value": "Retail"
        },
        {
            "Key": "Product_Line",
            "Value": "Shoes"
        },
        {
            "Key": "Location",
            "Value": "Denver"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mencantumkan tag untuk sumber daya: list-tags-for-resource di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanlist-work-groups.

AWS CLI

Untuk daftar kelompok kerja

list-work-groupsContoh berikut mencantumkan workgroup di akun saat ini.

aws athena list-work-groups

Output:

{
    "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
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola Grup Kerja di Panduan Pengguna Amazon Athena.

  • Untuk API detailnya, lihat ListWorkGroupsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanstart-query-execution.

AWS CLI

Contoh 1: Untuk menjalankan kueri dalam workgroup pada tabel yang ditentukan dalam database dan katalog data yang ditentukan

start-query-executionContoh berikut menggunakan AthenaAdmin workgroup untuk menjalankan query pada cloudfront_logs tabel di cflogsdatabase dalam katalog AwsDataCatalog data.

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

Output:

{
"QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh 2: Untuk menjalankan kueri yang menggunakan workgroup tertentu untuk membuat database dalam katalog data tertentu

start-query-executionContoh berikut menggunakan AthenaAdmin workgroup untuk membuat database newdb dalam katalog AwsDataCatalog data default.

aws athena start-query-execution \
    --query-string "create database if not exists newdb" \
    --work-group "AthenaAdmin"

Output:

{
"QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11112"
}

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh 3: Untuk menjalankan kueri yang membuat tampilan pada tabel dalam database dan katalog data yang ditentukan

start-query-executionContoh berikut menggunakan SELECT pernyataan pada cloudfront_logs tabel di cflogsdatabase untuk membuat tampilancf10.

aws athena start-query-execution \
    --query-string  "CREATE OR REPLACE VIEW cf10 AS SELECT * FROM cloudfront_logs limit 10" \
    --query-execution-context Database=cflogsdatabase

Output:

{
"QueryExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11113"
}

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanstop-query-execution.

AWS CLI

Untuk menghentikan kueri yang sedang berjalan

stop-query-executionContoh berikut menghentikan query yang memiliki ID query tertentu.

aws athena stop-query-execution \
    --query-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menjalankan SQL Kueri Menggunakan Amazon Athena di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambahkan tanda ke sumber daya

tag-resourceContoh berikut menambahkan tiga tag ke katalog dynamo_db_catalog data.

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

Perintah ini tidak menghasilkan output. Untuk melihat hasilnya, gunakanaws athena list-tags-for-resource --resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog.

Untuk informasi selengkapnya, lihat Menambahkan tag ke sumber daya: tag-resource di Panduan Pengguna Amazon Athena.

  • Untuk API detailnya, lihat TagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari sumber daya

untag-resourceContoh berikut menghapus Focus kunci Specialization dan dan nilai yang terkait dari sumber daya katalog dynamo_db_catalog data.

aws athena untag-resource \
    --resource-arn arn:aws:athena:us-west-2:111122223333:datacatalog/dynamo_db_catalog \
    --tag-keys Specialization Focus

Perintah ini tidak menghasilkan output. Untuk melihat hasilnya, gunakan list-tags-for-resource perintah.

Untuk informasi selengkapnya, lihat Menghapus tag dari sumber daya: untag-resource di Panduan Pengguna Amazon Athena.

  • Untuk API detailnya, lihat UntagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-data-catalog.

AWS CLI

Untuk memperbarui katalog data

update-data-catalogContoh berikut memperbarui fungsi Lambda dan deskripsi katalog cw_logs_catalog data.

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

Perintah ini tidak menghasilkan output. Untuk melihat hasilnya, gunakanaws athena get-data-catalog --name cw_logs_catalog.

Untuk informasi selengkapnya, lihat Memperbarui Katalog: update-data-catalog di Panduan Pengguna Amazon Athena.

Contoh kode berikut menunjukkan cara menggunakanupdate-work-group.

AWS CLI

Untuk memperbarui workgroup

update-work-groupContoh berikut menonaktifkan Data_Analyst_Group workgroup. Pengguna tidak dapat menjalankan atau membuat kueri di grup kerja yang dinonaktifkan, tetapi masih dapat melihat metrik, kontrol batas penggunaan data, pengaturan grup kerja, riwayat kueri, dan kueri yang disimpan.

aws athena update-work-group \
    --work-group Data_Analyst_Group \
    --state DISABLED

Perintah ini tidak menghasilkan output. Untuk memverifikasi perubahan status, gunakan aws athena get-work-group --work-group Data_Analyst_Group dan periksa State properti di output.

Untuk informasi selengkapnya, lihat Mengelola Grup Kerja di Panduan Pengguna Amazon Athena.