Riferimento alle operazioni dell’API dati di Amazon RDS - Amazon Aurora

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riferimento alle operazioni dell’API dati di Amazon RDS

L’API dati di Amazon RDS fornisce le seguenti operazioni per eseguire istruzioni SQL.

Operazione API dati

AWS CLI command

Descrizione

ExecuteStatement

aws rds-data execute-statement

Esegue un'istruzione SQL in un database.

BatchExecuteStatement

aws rds-data batch-execute-statement

Esegue un'istruzione SQL batch su un array di dati per operazioni di aggiornamento in blocco e di inserimento. Puoi eseguire un'istruzione DML (Data Manipolation Language) con una matrice di set di parametri. Un'istruzione SQL batch può fornire un miglioramento significativo delle prestazioni su singole operazioni di inserimento e aggiornamento.

Puoi utilizzare entrambe le operazioni per eseguire singole istruzioni SQL o per eseguire transazioni. L’API dati fornisce le seguenti operazioni per le transazioni.

Operazione API dati

AWS CLI command

Descrizione

BeginTransaction

aws rds-data begin-transaction

Inizia una transazione SQL.

CommitTransaction

aws rds-data commit-transaction

Termina una transazione SQL ed esegue il commit delle modifiche.

RollbackTransaction

aws rds-data rollback-transaction

Esegue un rollback di una transazione.

Le operazioni per l'esecuzione di istruzioni SQL e il supporto delle transazioni dispongono dei seguenti parametri API dati e opzioni AWS CLI comuni. Alcune operazioni supportano altri parametri o opzioni.

Parametro operazione API dati

AWS CLIOpzione comando

Campo obbligatorio

Descrizione

resourceArn

--resource-arn

Sì

Il nome della risorsa Amazon (ARN) del cluster di database Aurora. Il cluster deve trovarsi nello stesso Account AWS dell’utente IAM o del ruolo IAM che invoca l’API dati. Per accedere a un cluster in un account diverso, assumi un ruolo in tale account.

secretArn

--secret-arn

Sì

Il nome o l'ARN del secreto che abilita l'accesso al cluster database.

L’API dati di RDS supporta i seguenti tipi di dati per 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)

L’API dati di RDS supporta i seguenti tipi scalari di Aurora PostgreSQL:

  • 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

L’API dati di RDS supporta i seguenti tipi di array di Aurora PostgreSQL:

  • BOOL[], BIT[]

  • DATE[]

  • DECIMAL[], NUMERIC[]

  • FLOAT8[], DOUBLE PRECISION[]

  • INT[], INT4[]

  • INT2[]

  • INT8[], BIGINT[]

  • JSON[]

  • REAL[], FLOAT[]

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

  • TIME[]

  • TIMESTAMP[]

  • UUID[]

Puoi utilizzare parametri nelle chiamate API dati per ExecuteStatement e BatchExecuteStatement e quando esegui i comandi AWS CLI execute-statement e batch-execute-statement. Per utilizzare un parametro, specifica una coppia nome-valore nel tipo di dati SqlParameter. Specifica il valore con il tipo di dati Field. La tabella seguente associa i tipi di dati Java Database Connectivity (JDBC) ai tipi di dati specificati nelle chiamate API dati.

Tipo di dati JDBC

Tipo di dati API dati

INTEGER, TINYINT, SMALLINT, BIGINT

LONG (o STRING)

FLOAT, REAL, DOUBLE

DOUBLE

DECIMAL

STRING

BOOLEAN, BIT

BOOLEAN

BLOB, BINARY, LONGVARBINARY, VARBINARY

BLOB

CLOB

STRING

Altri tipi (inclusi i tipi correlati a data e ora)

STRING
Nota

Puoi specificare il tipo di dati LONG o STRING nella chiamata all’API data per i valori LONG restituiti dal database. Si consiglia di farlo per evitare di perdere precisione per numeri estremamente grandi, cosa che può accadere quando si lavora con JavaScript.

Alcuni tipi, ad esempio DECIMAL e TIME, richiedono un suggerimento in modo che l’API dati passi i valori String al database come tipo corretto. Per utilizzare un suggerimento, includere i valori per typeHint nel tipo di dati SqlParameter. i seguito sono riportati i valori possibili per typeHint:

  • DATE – Il valore del parametro String corrispondente viene inviato come oggetto di tipo DATE al database. Il formato accettato è YYYY-MM-DD.

  • DECIMAL – Il valore del parametro String corrispondente viene inviato come oggetto di tipo DECIMAL al database.

  • JSON – Il valore del parametro String corrispondente viene inviato come oggetto di tipo JSON al database.

  • TIME – Il valore del parametro String corrispondente viene inviato come oggetto di tipo TIME al database. Il formato accettato è HH:MM:SS[.FFF].

  • TIMESTAMP – Il valore del parametro String corrispondente viene inviato come oggetto di tipo TIMESTAMP al database. Il formato accettato è YYYY-MM-DD HH:MM:SS[.FFF].

  • UUID – Il valore del parametro String corrispondente viene inviato come oggetto di tipo UUID al database.

    Nota

    Attualmente, l’API dati non supporta array di identificatori univoci universali (UUID).

Nota

Per Amazon Aurora PostgreSQL, l’API dati restituisce sempre il tipo di dati Aurora PostgreSQL TIMESTAMPTZ nel fuso orario UTC.