Condividi tramite

Regole di denominazione degli oggetti (Analysis Services)

  • Articolo

Si applica a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Questo argomento descrive le convenzioni di denominazione degli oggetti, nonché le parole riservate e i caratteri che non possono essere usati in qualsiasi nome oggetto, nel codice o nello script in SQL Server Analysis Services.

Convenzioni di denominazione

Ogni oggetto ha una proprietà Name e ID che deve essere univoca nell'ambito dell'insieme padre. Ad esempio, due dimensioni possono avere lo stesso nome fintanto che ciascuna risiede in un database diverso.

Anche se è possibile specificarlo manualmente, l'ID viene in genere generato automaticamente quando viene creato l'oggetto. Non è mai necessario modificare l'ID dopo aver iniziato a creare un modello. Tutti i riferimenti a oggetti in un modello si basano sull'ID. Pertanto, la modifica di un ID può causare facilmente il danneggiamento del modello.

Gli oggetti DataSource e DataSourceView presentano eccezioni importanti alle convenzioni di denominazione. Datasource L'ID può essere impostato su un singolo punto (.), che non è univoco, come riferimento al database corrente. Una seconda eccezione è DataSourceView, che rispetta le convenzioni di denominazione definite per gli oggetti DataSet in .NET Framework, in cui il nome viene usato come identificatore.

Le regole seguenti si applicano alle proprietà Name e ID .

  • Per i nomi non viene fatta distinzione tra maiuscole e minuscole. Non è possibile avere un cubo denominato "sales" e un altro denominato "Sales" nello stesso database.

  • Gli spazi iniziali o finali non sono consentiti nel nome dell'oggetto, sebbene sia possibile incorporare gli spazi all'interno del nome. Gli spazi iniziali e finali vengono eliminati in modo implicito. Ciò si applica sia al nome che all'ID di un oggetto.

  • Il numero massimo di caratteri consentito è 100.

  • Non esiste alcun particolare requisito per il primo carattere di un identificatore, che può pertanto essere qualsiasi carattere valido.

Parole e caratteri riservati

Le parole riservate sono in inglese e si applicano ai nomi di oggetto, non alle didascalie. Se si utilizza inavvertitamente una parola riservata in un nome di oggetto, si verificherà un errore di convalida. Per i modelli di data mining e multidimensionali, le parole riservate descritte di seguito non possono mai essere utilizzate in alcun nome di oggetto.

Per i modelli tabulari dove la compatibilità di database è impostata su 1103, le regole di convalida sono state rese flessibili per alcuni oggetti, non conformi per i requisiti di caratteri estesi e le convenzioni di denominazione di alcune applicazioni client. I database che soddisfano questi criteri sono soggetti a regole di convalida meno restrittive. In questo caso è possibile che un nome di oggetto includa un carattere limitato e superi comunque la convalida.

Parole riservate

  • AUX

  • CLOCK$

  • COM1 tramite COM9 (COM1, COM2, COM3 e così via)

  • CON

  • LPT1 tramite LPT9 (LPT1, LPT2, LPT3 e così via)

  • NUL

  • PRN

  • Non è consentito utilizzare NULL come carattere in una stringa all'interno del frammento XML

Caratteri riservati

Nella tabella seguente sono elencati i caratteri non validi per oggetti specifici.

Oggetto Caratteri non validi
Server Seguire le convenzioni di denominazione del server Windows quando si denomina un oggetto server. Per informazioni dettagliate, vedere Convenzioni di denominazione (Windows).
DataSource : / \ * | ? " () [] {}<>
Livello o attributo . , ; ' ` : / \ * | ? " & % $ ! + = [] {}<>
Dimensione o gerarchia . , ; ' ` : / \ * | ? " & % $ ! + = () [] {}<,>
Tutti gli altri oggetti . , ; ' ` : / \ * | ? " & % $ ! + = () [] {}<>

Eccezioni: quando sono consentiti i caratteri riservati

Come è stato notato, i database di un livello di compatibilità e di modalità specifico possono avere nomi di oggetti che includono caratteri riservati. I nomi di attributi della dimensione, gerarchie, livelli, misuri e oggetti KPI possono includere caratteri riservati, per database tabulari (1103 o un valore superiore) che consentono l'utilizzo di caratteri estesi:

Livello di compatibilità del database e modalità del server Caratteri riservati consentiti?
MOLAP (tutte le versioni) No
Tabulare - 1050 No
Tabulare - 1100 No
Tabulare - 1130 e versioni successive Sì

I database possono avere un valore ModelType predefinito. Il valore predefinito è equivalente a multidimensionale e quindi non supporta l'utilizzo di caratteri riservati nei nomi delle colonne.

Vedere anche

Parole riservate MDX
Supporto delle traduzioni in Analysis Services