Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
ExecuteQuery
Jalankan kueri untuk mengakses informasi dari grafik pengetahuan Anda tentang entitas dalam ruang kerja individu.
catatan
T ExecuteQuery indakan ini hanya berfungsi dengan AWS Java SDK2. ExecuteQuery tidak akan berfungsi dengan versi AWS Java SDK < 2.x.
Minta Sintaks
POST /queries/execution HTTP/1.1
Content-type: application/json
{
"maxResults": number,
"nextToken": "string",
"queryStatement": "string",
"workspaceId": "string"
}Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- maxResults
-
Jumlah maksimum hasil untuk dikembalikan pada satu waktu. Defaultnya adalah 50.
Tipe: Bilangan Bulat
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 100.
Wajib: Tidak
- nextToken
-
String yang menentukan halaman hasil berikutnya.
Tipe: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 17880.
Pola:
.*Wajib: Tidak
- queryStatement
-
Pernyataan kueri.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1000.
Pola:
[\s\S]+Wajib: Ya
- workspaceId
-
ID ruang kerja.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola:
[a-zA-Z_0-9][a-zA-Z_\-0-9]*[a-zA-Z0-9]+Diperlukan: Ya
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"columnDescriptions": [
{
"name": "string",
"type": "string"
}
],
"nextToken": "string",
"rows": [
{
"rowData": [ JSON value ]
}
]
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- columnDescriptions
-
Daftar ColumnDescription objek.
Tipe: Array objek ColumnDescription
- nextToken
-
String yang menentukan halaman hasil berikutnya.
Tipe: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 17880.
Pola:
.* - rows
-
Merupakan satu baris dalam hasil kueri.
Tipe: Array objek Row
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Jenis Kesalahan Umum.
- AccessDeniedException
-
Akses ditolak.
Kode Status HTTP: 403
- InternalServerException
-
Kesalahan tak terduga telah terjadi.
Kode Status HTTP: 500
- QueryTimeoutException
-
Pengecualian batas waktu kueri.
Kode Status HTTP: 400
- ServiceQuotaExceededException
-
Kuota layanan terlampaui.
Kode Status HTTP: 402
- ThrottlingException
-
Tarifnya melebihi batas.
Kode Status HTTP: 429
- ValidationException
-
Gagal
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang menggunakan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
