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 comando

Description

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 comando

Description

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 hanno i seguenti parametri e AWS CLI opzioni comuni di Data API. Alcune operazioni supportano altri parametri o opzioni.

Parametro operazione API dati

AWS CLI opzione di comando

Richiesto

Descrizione

resourceArn

--resource-arn

Sì

Il nome della risorsa Amazon (ARN) del cluster di database Aurora. Il cluster deve avere lo stesso Account AWS ruolo o utente IAM che richiama l'API Data. 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 i parametri nelle chiamate Data API a ExecuteStatement eBatchExecuteStatement, quando AWS CLI esegui i comandi 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. Ti consigliamo di farlo per evitare di perdere la precisione per numeri estremamente grandi, cosa che può succedere quando lavori 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, Data API non supporta array di Universal Unique Identifiers ()UUIDs.

Nota

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