Riferimento alle operazioni dell'API Amazon RDS Data - 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 Amazon RDS Data

L'API Amazon RDS Data fornisce le seguenti operazioni per eseguire istruzioni SQL.

Operazione API dati

AWS CLI comando

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. Per le transazioni, Data API fornisce le seguenti operazioni.

Operazione API dati

AWS CLI comando

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 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ì

L'Amazon Resource Name (ARN) del cluster Aurora DB. 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 quell'account.

secretArn

--secret-arn

Sì

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

RDS Data API 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)

RDS Data API supporta i seguenti tipi scalari 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

RDS Data API supporta i seguenti tipi di array 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[]

È possibile utilizzare i parametri nelle chiamate Data API verso ExecuteStatement eBatchExecuteStatement, quando si eseguono i comandi e. AWS CLI execute-statement 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, come DECIMAL eTIME, richiedono un suggerimento affinché Data API passi String i valori 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, Data API restituisce sempre il tipo di dati Aurora PostgreSQL nel fuso orario UTC. TIMESTAMPTZ