Condividi tramite


Comando .create table based-on

Si applica a: ✅Microsoft FabricAzure 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:

Autorizzazioni

Per eseguire questo comando, è necessario disporre almeno delle autorizzazioni di amministratore del database.

Sintassi

.createtableName 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.

Esempio

.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")