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à.
# Panoramica di SQL in AWS Clean Rooms
Benvenuto in *AWS Clean RoomsSQL Reference.*
AWS Clean Roomsè basato sullo standard di settore Structured Query Language (SQL), un linguaggio di interrogazione costituito da comandi e funzioni utilizzati per lavorare con database e oggetti di database. SQL impone inoltre regole relative all'uso di tipi di dati, espressioni e valori letterali.
Negli argomenti seguenti vengono fornite informazioni generali sulle convenzioni e le regole di denominazione utilizzate in questo riferimento SQL.
**Topics**
+ [Convenzioni del riferimento SQL](sql-ref-conventions.md)
+ [Regole di denominazione SQL](sql-ref-naming.md)
+ [Supporto dei tipi di dati tramite il motore SQL](sql-reference-supported-data-types-dialect.md)
Le sezioni seguenti forniscono informazioni sui valori letterali, i tipi di dati, i comandi SQL, i tipi di funzioni SQL e le condizioni SQL in cui è possibile utilizzare. AWS Clean Rooms
+ [AWS Clean Rooms SQL Spark](sql-reference-spark.md)
Per ulteriori informazioni in meritoAWS Clean Rooms, consulta la [Guida per l'AWS Clean Roomsutente](https://docs.aws.amazon.com/clean-rooms/latest/userguide/what-is.html) e l'[AWS Clean RoomsAPI Reference.](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html)
# Convenzioni del riferimento SQL
Questa sezione spiega le convenzioni utilizzate per scrivere la sintassi per le espressioni, i comandi e le funzioni SQL.
| Carattere | Descrizione |
| --- | --- |
| CAPS | Le parole in lettere maiuscole sono parole chiave. |
| [ ] | Le parentesi indicano argomenti opzionali. Più argomenti tra parentesi indicano che è possibile scegliere qualsiasi numero degli argomenti. Inoltre, gli argomenti tra parentesi su righe separate indicano che il parser prevede che gli argomenti siano nell'ordine in cui sono elencati nella sintassi. |
| \$1 \$1 | Le parentesi graffe indicano che è necessario scegliere uno degli argomenti racchiusi nelle stesse. |
| \$1 | Le pipe indicano che è possibile scegliere tra gli argomenti. |
| corsivo | Le parole in corsivo indicano dei segnaposto. Devi inserire il valore appropriato al posto della parola in corsivo. |
| ... | I puntini di sospensione indicano che è possibile ripetere l'elemento precedente. |
| ' | Le parole tra virgolette singole indicano che è necessario digitare le virgolette. |
# Regole di denominazione SQL
Le seguenti sezioni spiegano le regole di denominazione SQL in. AWS Clean Rooms
**Topics**
+ [Nomi e colonne delle associazioni di tabelle configurate](#confg-table-and-column-naming-rules)
+ [Parole riservate](#reserved-words)
## Nomi e colonne delle associazioni di tabelle configurate
I membri che possono eseguire query utilizzano i nomi di associazione di tabelle configurati come nomi di tabella nelle query. I nomi di associazione di tabelle configurati e le colonne di tabella configurate possono essere alias nelle query.
Le seguenti regole di denominazione si applicano ai nomi di associazione di tabelle configurati, ai nomi di colonne delle tabelle configurate e agli alias:
+ Devono utilizzare solo caratteri alfanumerici, caratteri di sottolineatura (\$1) o trattino (-), ma non possono iniziare o terminare con un trattino.
+ (*Solo regole di analisi personalizzate*) Possono utilizzare il simbolo del dollaro (\$1) ma non uno schema che segue una costante di stringa tra virgolette in dollari.
Una costante di stringa quotata in dollari è composta da:
+ il simbolo del dollaro (\$1)
+ un «tag» opzionale di zero o più caratteri
+ un altro simbolo del dollaro
+ sequenza arbitraria di caratteri che costituisce il contenuto della stringa
+ il simbolo del dollaro (\$1)
+ lo stesso tag con cui è iniziata la quotazione in dollari
+ il simbolo del dollaro
Ad esempio: `$$invalid$$`
+ Non possono contenere trattini consecutivi (-).
+ Non possono iniziare con nessuno dei seguenti prefissi:
`padb_`, `pg_`, `stcs_`, `stl_`, `stll_`, `stv_`, `svcs_`, `svl_`, `svv_`, `sys_`, `systable_`
+ Non possono contenere barre rovesciate (\$1), virgolette (') o spazi che non siano tra virgolette.
+ Se iniziano con un carattere non alfabetico, devono essere racchiusi tra virgolette (» «).
+ Se contengono un trattino (-), devono essere racchiusi tra virgolette doppie (» «).
+ Devono avere una lunghezza compresa tra 1 e 127 caratteri.
+ [Le parole riservate](#reserved-words) devono essere racchiuse tra virgolette doppie (» «).
+ I seguenti nomi di colonna sono riservati e non possono essere utilizzati in AWS Clean Rooms (anche con virgolette):
+ oid
+ tableoid
+ xmin
+ cmin
+ xmax
+ cmax
+ ctid
## Parole riservate
Di seguito è riportato un elenco di parole riservate in AWS Clean Rooms.
| | | | |
| --- |--- |--- |--- |
| AES128 | DELTA32KDESC | LEADING | PRIMARY |
| AES256ALL | DISTINCT | LEFTLIKE | RAW |
| ALLOWOVERWRITEANALYSE | DO | LIMIT | READRATIO |
| ANALYZE | DISABLE | LOCALTIME | RECOVERREFERENCES |
| AND | ELSE | LOCALTIMESTAMP | REJECTLOG |
| ANY | EMPTYASNULLENABLE | LUN | RESORT |
| ARRAY | ENCODE | LUNS | RESPECT |
| AS | ENCRYPT | LZO | RESTORE |
| ASC | ENCRYPTIONEND | LZOP | RIGHTSELECT |
| AUTHORIZATION | EXCEPT | MINUS | SESSION\$1USER |
| AZ64 | EXPLICITFALSE | MOSTLY16 | SIMILAR |
| BACKUPBETWEEN | FOR | MOSTLY32 | SNAPSHOT |
| BINARY | FOREIGN | MOSTLY8NATURAL | SOME |
| BLANKSASNULLBOTH | FREEZE | NEW | SYSDATESYSTEM |
| BYTEDICT | FROM | NOT | TABLE |
| BZIP2CASE | FULL | NOTNULL | TAG |
| CAST | GLOBALDICT256 | NULL | TDES |
| CHECK | GLOBALDICT64KGRANT | NULLSOFF | TEXT255 |
| COLLATE | GROUP | OFFLINEOFFSET | TEXT32KTHEN |
| COLUMN | GZIPHAVING | OID | TIMESTAMP |
| CONSTRAINT | IDENTITY | OLD | TO |
| CREATE | IGNOREILIKE | ON | TOPTRAILING |
| CREDENTIALSCROSS | IN | ONLY | TRUE |
| CURRENT\$1DATE | INITIALLY | OPEN | TRUNCATECOLUMNSUNION |
| CURRENT\$1TIME | INNER | OR | UNIQUE |
| CURRENT\$1TIMESTAMP | INTERSECT | ORDER | UNNEST |
| CURRENT\$1USER | INTERVAL | OUTER | USING |
| CURRENT\$1USER\$1IDDEFAULT | INTO | OVERLAPS | VERBOSE |
| DEFERRABLE | IS | PARALLELPARTITION | WALLETWHEN |
| DEFLATE | ISNULL | PERCENT | WHERE |
| DEFRAG | JOIN | PERMISSIONS | WITH |
| DELTA | LANGUAGE | PIVOTPLACING | WITHOUT |
# Supporto dei tipi di dati tramite il motore SQL
AWS Clean Rooms supporta più motori e dialetti SQL. La comprensione dei sistemi di tipi di dati in queste implementazioni è fondamentale per una collaborazione e un'analisi dei dati di successo. Le tabelle seguenti mostrano i tipi di dati equivalenti tra AWS Clean Rooms SQL, Snowflake SQL e Spark SQL.
## Tipi di dati numerici
I tipi numerici rappresentano vari tipi di numeri, da numeri interi precisi a valori approssimativi in virgola mobile. La scelta del tipo numerico influisce sia sui requisiti di archiviazione che sulla precisione computazionale. I tipi di numeri interi variano in base alla dimensione del byte, mentre i tipi decimali e a virgola mobile offrono diverse opzioni di precisione e scala.
| Tipo di dati | AWS Clean Rooms SQL | SQL a forma di fiocco di neve | Spark SQL | Description |
| --- | --- | --- | --- | --- |
| Numero intero a 8 byte | BIGINT | Non supportata | BIGINT, LUNGO | Numeri interi con segno da -9.223.372.036.854.775.808 a 9.223.372.036.854.775.807. |
| Numero intero a 4 byte | INT | Non supportata | INT, INTEGER | Numeri interi con segno da -2.147.483.648 a 2.147.483.647 |
| Numero intero a 2 byte | SMALLINT | Non supportata | SMALLINT, BREVE | Numeri interi con segno da -32.768 a 32.767 |
| Numero intero a 1 byte | Non supportata | Non supportata | TINYINT, BYTE | Numeri interi con segno da -128 a 127 |
| Flottante a doppia precisione | DOPPIA, DOPPIA PRECISIONE | FLOAT,, FLOAT4 FLOAT8, DOPPIA, DOPPIA PRECISIONE, REALE | DOUBLE | Numeri in virgola mobile a doppia precisione da 8 byte |
| Flottante a precisione singola | REALE, GALLEGGIANTE | Non supportata | FLOAT | numeri in virgola mobile a precisione singola a 4 byte |
| Decimale (precisione fissa) | DECIMAL | DECIMALE, NUMERICO, NUMERO Snowflake assegna automaticamente l'alias dei tipi numerici esatti di larghezza inferiore (INT, BIGINT, SMALLINT, ecc.) a NUMBER. | DECIMALE, NUMERICO, | numeri decimali con segno a precisione arbitraria |
| Decimale (con precisione) | DECIMALE (p) | NUMERO DECIMALE (p), NUMERO (p) | DECIMALE (p) | Numeri decimali a precisione fissa |
| Decimale (con scala) | DECIMAL(p,s) | NUMERO DECIMALE (p, s), NUMERO (p, s) | DECIMAL(p,s) | Numeri decimali a precisione fissa con scala |
## Tipi di dati booleani
I tipi booleani rappresentano valori logici semplici. true/false Questi tipi sono coerenti tra i motori SQL e vengono comunemente utilizzati per flag, condizioni e operazioni logiche.
| Tipo di dati | AWS Clean Rooms SQL | SQL a forma di fiocco di neve | Spark SQL | Description |
| --- | --- | --- | --- | --- |
| Booleano | BOOLEAN | BOOLEAN | BOOLEAN | Rappresenta i valori true/false |
## Tipi di dati data e ora
I tipi di data e ora gestiscono i dati temporali, con diversi livelli di precisione e consapevolezza del fuso orario. Questi tipi supportano diversi formati per la memorizzazione di date, ore e timestamp, con opzioni per includere o escludere le informazioni sul fuso orario.
| Tipo di dati | AWS Clean Rooms SQL | SQL a forma di fiocco di neve | Spark SQL | Description |
| --- | --- | --- | --- | --- |
| Data | DATE | DATE | DATE | Valori di data (anno, mese, giorno) senza fuso orario |
| Orario | TIME | Non supportata | Non supportata | Ora del giorno in UTC, senza fuso orario |
| Ora con TZ | TIMETZ | Non supportata | Non supportata | Ora del giorno in UTC, con fuso orario |
| Time stamp | TIMESTAMP | TIMESTAMP, TIMESTAMP\$1NTZ | TIMESTAMP\$1NTZ | Timestamp senza fuso orario NTZ indica «Nessun fuso orario» |
| Timestamp con TZ | TIMESTAMPTZ | TIMESTAMP\$1LTZ | TIMESTAMP, TIMESTAMP\$1LTZ | Timestamp con fuso orario locale LTZ indica «Fuso orario locale» |
## Tipi di dati dei caratteri
I tipi di caratteri memorizzano dati testuali, offrendo opzioni a lunghezza fissa e a lunghezza variabile. Questi tipi gestiscono stringhe di testo e dati binari, con specifiche di lunghezza opzionali per controllare l'allocazione dello storage.
| Tipo di dati | AWS Clean Rooms SQL | SQL a forma di fiocco di neve | Spark SQL | Description |
| --- | --- | --- | --- | --- |
| Carattere a lunghezza fissa | CHAR | CHAR, CHARACTER | CHAR, CHARACTER | Stringa di caratteri a lunghezza fissa |
| Carattere a lunghezza fissa con lunghezza | CHAR(n) | CHAR(n), CHARACTER(n) | CHAR(n), CHARACTER(n) | Stringa di caratteri a lunghezza fissa con lunghezza specificata |
| Carattere a lunghezza variabile | VARCHAR | VARCHAR, STRINGA, TESTO | VARCHAR, STRINGA | Stringa di caratteri a lunghezza variabile |
| Carattere a lunghezza variabile con lunghezza | VARCHAR(n) | VARCHAR (n), STRINGA (n), TESTO (n) | VARCHAR(n) | Stringa di caratteri a lunghezza variabile con limite di lunghezza |
| Binario | VARBYTE | BINARY, VARBINARY | BINARY | Sequenza binaria di byte |
| Binario con lunghezza | VARBYTE(n) | Non supportata | Non supportata | Sequenza binaria di byte con limite di lunghezza |
## Tipi di dati strutturati
I tipi strutturati consentono un'organizzazione complessa dei dati combinando più valori in singoli campi. Questi includono array per raccolte ordinate, mappe per coppie chiave-valore e strutture per la creazione di strutture di dati personalizzate con campi denominati.
| Tipo di dati | AWS Clean Rooms SQL | SQL a forma di fiocco di neve | Spark SQL | Description |
| --- | --- | --- | --- | --- |
| Array | MATRICE | ARRAY (tipo) | ARRAY | Sequenza ordinata di elementi dello stesso tipo I tipi di array devono contenere elementi dello stesso tipo |
| Eseguire la mappatura | MAPPA | MAP (chiave, valore) | MAPPA | Raccolta di coppie chiave-valore I tipi di mappa devono contenere elementi dello stesso tipo |
| Struct | STRUTTURA< field1: type1, field2: type2> | OGGETTO (campo1 tipo1, campo2 tipo2) | STRUTTURA< field1: type1, field2: type2 > | Struttura con campi denominati di tipi specificati La sintassi dei tipi strutturati può variare leggermente tra le implementazioni |
| Fantastico | SUPER | Non supportata | Non supportata | Tipo flessibile che supporta tutti i tipi di dati, compresi i tipi complessi |