Regole di denominazione degli oggetti (Analysis Services)
Si applica a:
SQL Server Analysis Services
Azure Analysis Services
Power BI Premium
In questo argomento vengono descritte le convenzioni di denominazione dell'oggetto, le parole riservate e i caratteri che non possono essere utilizzati nel nome dell'oggetto, nel codice o nello script in Analysis Services.
Convenzioni di denominazione
Ogni oggetto ha una proprietà Name e ID che deve essere univoca all'interno dell'ambito della raccolta padre. Ad esempio, due dimensioni possono avere lo stesso nome fintanto che ciascuna risiede in un database diverso.
Sebbene sia possibile specificarlo manualmente, l'ID viene in genere generato automaticamente quando viene creato l'oggetto. Non modificare mai l'ID dopo aver iniziato a creare un modello. Tutti i riferimenti agli oggetti in un modello sono basati sull'ID. Di conseguenza, la modifica di un ID può facilmente causare il danneggiamento del modello.
Gli oggetti DataSource e DataSourceView hanno eccezioni di base alle convenzioni di denominazione. Origine dati 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 nel .NET Framework, in cui Name 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 cubo 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. Questo vale sia per il nome che per l'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