Gestire il completamento alla pressione del tasto TAB (SQL Server PowerShell)

  • Articolo

Si applica a:SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsPiattaforma di strumenti analitici (PDW)

Gli snap-in SQL Server PowerShell introducono tre variabili ($SqlServerMaximumTabCompletion, $SqlServerMaximumChildItems e $SqlServerIncludeSystemObjects) per controllare il completamento alla pressione del tasto TAB di Windows PowerShell. Il completamento alla pressione del tasto TAB consente di ridurre la digitazione restituendo tabelle di elementi i cui nomi iniziano con la stringa che si sta digitando.

Nota

Esistono due moduli SQL Server PowerShell: SqlServer e SQLPS.

SqlServer è il modulo corrente di PowerShell da usare.

SQLPS è incluso nell'installazione di SQL Server (per compatibilità con le versioni precedenti), ma non viene più aggiornato.

Il modulo SqlServer contiene le versioni aggiornate dei cmdlet di SQLPS e include nuovi cmdlet per il supporto delle funzionalità SQL più recenti.

Installare il modulo SqlServer da PowerShell Gallery.

Per altre informazioni, vedere SQL Server PowerShell.

Con il completamento alla pressione del tasto TAB di Windows PowerShell, dopo aver digitato parte del nome di un percorso o di un cmdlet, è possibile premere il tasto TAB per ottenere un elenco degli elementi il cui nome corrisponde a quanto già digitato. È quindi possibile selezionare l'elemento desiderato dall'elenco senza digitare il resto del nome.

Se si usa un database che contiene molti oggetti, gli elenchi di completamento alla pressione del tasto TAB possono diventare molto grandi. Anche alcuni tipi di oggetto di SQL Server, ad esempio le viste, includono numerosi oggetti di sistema.

Gli snap-in di SQL Server introducono tre variabili di sistema che possono essere usate per controllare la quantità di informazioni generata dal completamento alla pressione del tasto TAB e da Get-ChildItem.

$SqlServerMaximumTabCompletion =** n

Specifica il numero massimo di oggetti da includere in un elenco di completamento alla pressione del tasto TAB. Se si seleziona il tasto TAB in un nodo del percorso con più di n oggetti, l'elenco di completamento alla pressione del tasto TAB viene troncato in corrispondenza di n. n è un numero intero. L'impostazione predefinita è 0, che indica che non esiste alcun limite al numero di oggetti elencati.

$SqlServerMaximumChildItems =** n

Specifica il numero massimo di oggetti visualizzati da Get-ChildItem. Se Get-ChildItem viene eseguito in un nodo del percorso con più di n oggetti, l'elenco viene troncato in corrispondenza di n. n è un numero intero. L'impostazione predefinita è 0, che indica che non esiste alcun limite al numero di oggetti elencati.

$SqlServerIncludeSystemObjects =** { $True | $False }

Se $True, gli oggetti di sistema vengono visualizzati dal completamento alla pressione del tasto TAB e da Get-ChildItem. Se $False, non viene visualizzato alcun oggetto di sistema. L'impostazione predefinita è $False.

Impostazione delle variabili per il completamento alla pressione del tasto TAB

Per tutte le variabile di cui si desidera modificare il valore predefinito, impostare la variabile sul nuovo valore.

Esempio (PowerShell)

Nell'esempio seguente vengono impostate tutte e tre le variabili e vengono elencate le relative impostazioni:

$SqlServerMaximumTabCompletion = 20  
$SqlServerMaximumChildItems = 10  
$SqlServerIncludeSystemObjects = $False  
dir variable:sqlserver*

Vedi anche