Regole di denominazione degli oggetti (Analysis Services)

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

In questo argomento vengono descritte le convenzioni di denominazione degli oggetti, nonché le parole riservate e i caratteri che non possono essere usati in alcun nome di 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 della raccolta padre. Ad esempio, due dimensioni possono avere lo stesso nome, purché ognuna risieda in un database diverso.

Anche se è 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 a oggetti in un modello sono basati sull'ID. Di conseguenza, la modifica di un ID può causare facilmente il danneggiamento del modello.

Gli oggetti DataSource e DataSourceView presentano eccezioni rilevanti 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 .

  • I nomi non fanno distinzione tra maiuscole e minuscole. Non è possibile avere un cubo denominato "sales" e un altro denominato "Sales" nello stesso database.

  • Non sono consentiti spazi iniziali o finali in un nome di oggetto, anche se è possibile incorporare spazi all'interno di un nome. Gli spazi iniziali e finali vengono tagliati in modo implicito. Questo vale sia per il nome che per l'ID di un oggetto.

  • Il numero massimo di caratteri è 100.

  • Non esiste alcun requisito speciale per il primo carattere di un identificatore. Il primo carattere può essere qualsiasi carattere valido.

Parole riservate e caratteri

Le parole riservate sono in inglese e si applicano ai nomi degli oggetti, non alle didascalie. Se si usa 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 essere usate in alcun nome di oggetto, in qualsiasi momento.

Per i modelli tabulari, in cui la compatibilità del database è impostata su 1103, le regole di convalida sono state rilassate per determinati oggetti, non conformi ai requisiti di caratteri estesi e alle convenzioni di denominazione di determinate applicazioni client. I database che soddisfano questi criteri sono soggetti a regole di convalida meno rigorose. In questo caso, è possibile che un nome di oggetto includa un carattere con restrizioni e continui a superare la convalida.

Parole riservate

  • AUX

  • CLOCK$

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

  • CON

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

  • NUL

  • PRN

  • NULL non è consentito come carattere in alcuna stringa all'interno del codice 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 di Windows Server quando si assegna un nome a 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 caratteri riservati

Come indicato, i database di un livello di modalità e compatibilità specifici possono avere nomi di oggetto che includono caratteri riservati. I nomi degli oggetti dimensione, gerarchia, livello, misura e indicatore KPI possono includere caratteri riservati per i database tabulari (1103 o versioni successive) che consentono l'uso di caratteri estesi:

Modalità server e livello di compatibilità del database Caratteri riservati consentiti?
MOLAP (tutte le versioni) NO
Tabular - 1050 NO
Tabular - 1100 NO
Tabular - 1130 e versioni successive Yes

I database possono avere un ModelType predefinito. Il valore predefinito è equivalente a multidimensionale e pertanto non supporta l'uso di caratteri riservati nei nomi di colonna.

Vedere anche

Parole riservate MDX
Supporto per la traduzione in Analysis Services