Referensi operasi Amazon RDS Data API - Amazon Aurora

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

Referensi operasi Amazon RDS Data API

Amazon RDS Data API menyediakan operasi berikut untuk melakukan pernyataan SQL.

Operasi API Data

AWS CLI perintah

Deskripsi

ExecuteStatement

aws rds-data execute-statement

Menjalankan pernyataan SQL pada basis data.

BatchExecuteStatement

aws rds-data batch-execute-statement

Menjalankan pernyataan SQL batch pada array data untuk pembaruan massal dan operasi penyisipan. Anda dapat menjalankan pernyataan bahasa manipulasi data (DML) dengan array set parameter. Pernyataan SQL batch dapat memberikan peningkatan performa yang signifikan atas pernyataan penyisipan dan pembaruan individu.

Anda dapat menggunakan operasi mana pun untuk menjalankan pernyataan SQL individual atau untuk menjalankan transaksi. Untuk transaksi, Data API menyediakan operasi berikut.

Operasi API Data

AWS CLI perintah

Deskripsi

BeginTransaction

aws rds-data begin-transaction

Memulai transaksi SQL.

CommitTransaction

aws rds-data commit-transaction

Mengakhiri transaksi SQL dan menerapkan perubahan.

RollbackTransaction

aws rds-data rollback-transaction

Melakukan pembatalan transaksi.

Operasi untuk melakukan pernyataan SQL dan transaksi pendukung memiliki parameter dan AWS CLI opsi API Data umum berikut. Beberapa operasi mendukung parameter atau opsi lain.

Parameter operasi API Data

AWS CLI opsi perintah

Wajib

Deskripsi

resourceArn

--resource-arn

Ya

Nama Sumber Daya Amazon (ARN) dari cluster Aurora DB. Cluster harus Akun AWS sama dengan peran IAM atau pengguna yang memanggil API Data. Untuk mengakses klaster di akun yang berbeda, ambil peran dalam akun itu.

secretArn

--secret-arn

Ya

Nama atau ARN rahasia yang memungkinkan akses ke klaster basis data.

RDS Data API mendukung tipe data berikut untuk Aurora MySQL:

  • TINYINT(1), BOOLEAN, BOOL

  • TINYINT

  • SMALLINT [SIGNED | UNSIGNED]

  • MEDIUMINT [SIGNED | UNSIGNED]

  • INT [SIGNED | UNSIGNED]

  • BIGINT [SIGNED | UNSIGNED]

  • FLOAT

  • DOUBLE

  • VARCHAR, CHAR, TEXT, ENUM

  • VARBINARY, BINARY, BLOB

  • DATE, TIME, DATETIME, TIMESTAMP

  • DECIMAL

  • JSON

  • BIT, BIT(N)

RDS Data API mendukung jenis skalar Aurora PostgreSQL berikut:

  • BOOL

  • BYTEA

  • DATE

  • CIDR

  • DECIMAL, NUMERIC

  • ENUM

  • FLOAT8, DOUBLE PRECISION

  • INET

  • INT, INT4, SERIAL

  • INT2, SMALLINT, SMALLSERIAL

  • INT8, BIGINT, BIGSERIAL

  • JSONB, JSON

  • REAL, FLOAT

  • TEXT, CHAR(N), VARCHAR, NAME

  • TIME

  • TIMESTAMP

  • UUID

  • VECTOR

RDS Data API mendukung tipe array Aurora PostgreSQL berikut:

  • BOOL[], BIT[]

  • DATE[]

  • DECIMAL[], NUMERIC[]

  • FLOAT8[], DOUBLE PRECISION[]

  • INT[], INT4[]

  • INT2[]

  • INT8[], BIGINT[]

  • JSON[]

  • REAL[], FLOAT[]

  • TEXT[], CHAR(N)[], VARCHAR[], NAME[]

  • TIME[]

  • TIMESTAMP[]

  • UUID[]

Anda dapat menggunakan parameter dalam panggilan Data API ke ExecuteStatement danBatchExecuteStatement, dan ketika Anda menjalankan AWS CLI perintah execute-statement danbatch-execute-statement. Untuk menggunakan parameter, tentukan pasangan nama-nilai di tipe data SqlParameter. Tentukan nilai dengan tipe data Field. Tabel berikut memetakan tipe data Java Database Connectivity (JDBC) ke tipe data yang Anda tentukan dalam panggilan API Data.

Tipe data JDBC

Tipe data API Data

INTEGER, TINYINT, SMALLINT, BIGINT

LONG (atau STRING)

FLOAT, REAL, DOUBLE

DOUBLE

DECIMAL

STRING

BOOLEAN, BIT

BOOLEAN

BLOB, BINARY, LONGVARBINARY, VARBINARY

BLOB

CLOB

STRING

Tipe lainnya (termasuk tipe terkait tanggal dan waktu)

STRING
catatan

Anda dapat menentukan tipe data LONG atau STRING dalam panggilan API Data Anda untuk nilai LONG yang dihasilkan oleh basis data. Kami menyarankan Anda melakukannya untuk menghindari kehilangan presisi untuk jumlah yang sangat besar, yang dapat terjadi ketika Anda bekerja dengan JavaScript.

Tipe tertentu, seperti DECIMAL danTIME, memerlukan petunjuk agar Data API meneruskan String nilai ke database sebagai tipe yang benar. Untuk menggunakan petunjuk, sertakan nilai untuk typeHint di tipe data SqlParameter. Berikut adalah nilai-nilai yang mungkin untuk typeHint:

  • DATE – Nilai parameter String yang sesuai dikirim sebagai objek tipe DATE ke basis data. Format yang diterima adalah YYYY-MM-DD.

  • DECIMAL – Nilai parameter String yang sesuai dikirim sebagai objek tipe DECIMAL ke basis data.

  • JSON – Nilai parameter String yang sesuai dikirim sebagai objek tipe JSON ke basis data.

  • TIME – Nilai parameter String yang sesuai dikirim sebagai objek tipe TIME ke basis data. Format yang diterima adalah HH:MM:SS[.FFF].

  • TIMESTAMP – Nilai parameter String yang sesuai dikirim sebagai objek tipe TIMESTAMP ke basis data. Format yang diterima adalah YYYY-MM-DD HH:MM:SS[.FFF].

  • UUID – Nilai parameter String yang sesuai dikirim sebagai objek tipe UUID ke basis data.

    catatan

    Saat ini, Data API tidak mendukung array Universal Unique Identifiers ()UUIDs.

catatan

Untuk Amazon Aurora PostgreSQL, Data API selalu menampilkan tipe data Aurora PostgreSQL di zona waktu UTC. TIMESTAMPTZ