Comando .create table based-on
Si applica a: ✅Microsoft Fabric✅Azure Esplora dati
Crea una nuova tabella vuota basata su una tabella esistente. Questo comando deve essere eseguito nel contesto di un database specifico.
Nota
Tutte le proprietà della tabella di origine vengono copiate nella nuova tabella, con le eccezioni seguenti:
- Criteri di aggiornamento
- Entità autorizzate: quando si usa il
.create table based-on
comando , l'entità corrente viene aggiunta agli amministratori della tabella.
Autorizzazioni
Per eseguire questo comando, è necessario disporre almeno delle autorizzazioni di amministratore del database.
Sintassi
.create
tableName based-on
otherTable [ifnotexists
] [with
(
propertyName =
propertyValue [,
...])
]table
Altre informazioni sulle convenzioni di sintassi.
Parametri
Nome | Digita | Obbligatorio | Descrizione |
---|---|---|---|
ifnotexists |
string |
Se specificato, la tabella verrà creata solo se non esiste già. | |
tableName | string |
✔️ | Nome della tabella da creare. Il nome della distinzione tra maiuscole e minuscole deve essere univoco nel database. |
otherTable | string |
✔️ | Nome di una tabella esistente da utilizzare come origine per le colonne, la docstring e la cartella della tabella da creare. |
propertyName, propertyValue | string |
Elenco delimitato da virgole di coppie di proprietà chiave-valore. Vedere le proprietà supportate. |
Proprietà supportate
Nome | Tipo | Descrizione |
---|---|---|
docstring |
string |
Testo libero che descrive l'entità da aggiungere. Questa stringa viene presentata in varie impostazioni dell'esperienza utente accanto ai nomi delle entità. Il valore predefinito è Created basato su <tableName>. |
folder |
string |
Nome della cartella in cui aggiungere la tabella. Il valore predefinito è la stessa cartella di tableName. |
Valori restituiti
Questo comando restituisce lo schema della nuova tabella in formato JSON, simile all'esecuzione del comando seguente:
.show table MyLogs schema as json
Nota
- Se la tabella esiste già:
- Se
ifnotexists
viene specificato il flag, il comando viene ignorato (nessuna modifica applicata). - Se
ifnotexists
il flag NON è specificato, viene restituito un errore.
- Se
Esempio
.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")