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

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