Creazione e modifica di oggetti (XMLA)

Gli oggetti principali possono essere creati, modificati ed eliminati in modo indipendente. Gli oggetti principali includono gli oggetti seguenti:

• Server

• Banche dati

• Dimensioni

• Cubi

• Gruppi di misure

• Partizioni

• Prospettive

• Modelli di data mining

• Ruoli

• Comandi associati a un server o a un database

• Origini dati

Usare il comando Create per creare un oggetto principale in un'istanza di Microsoft SQL Server Analysis Services e il comando Alter per modificare un oggetto principale esistente in un'istanza di . Entrambi i comandi vengono eseguiti usando il metodo Execute .

Creazione di oggetti

Quando si creano oggetti utilizzando il Create metodo , è necessario innanzitutto identificare l'oggetto padre che contiene l'oggetto Analysis Services da creare. È possibile identificare l'oggetto padre fornendo un riferimento all'oggetto nella proprietà ParentObject del Create comando. Ogni riferimento all'oggetto contiene gli identificatori di oggetto necessari per identificare in modo univoco l'oggetto padre per il Create comando. Per altre informazioni sui riferimenti agli oggetti, vedere Definizione e identificazione di oggetti (XMLA).

Ad esempio, è necessario fornire un riferimento a un oggetto a un cubo per creare un nuovo gruppo di misure per il cubo. Il riferimento all'oggetto per il cubo nella ParentObject proprietà contiene sia un identificatore di database che un identificatore di cubo, in quanto lo stesso identificatore di cubo potrebbe essere utilizzato in un database diverso.

L'elemento ObjectDefinition contiene elementi ASSL (Analysis Services Scripting Language) che definiscono l'oggetto principale da creare. Per altre informazioni su ASSL, vedere Sviluppo con analysis Services Scripting Language (ASSL).

Se si imposta l'attributo AllowOverwrite del Create comando su true, è possibile sovrascrivere un oggetto principale esistente con l'identificatore specificato. In caso contrario, si verifica un errore se nell'oggetto padre esiste già un oggetto principale con l'identificatore specificato.

Per altre informazioni sul comando, vedere Create Element (XMLA).For more information about the Create command, see Create Element (XMLA).

Creazione di oggetti sessione

Gli oggetti sessione sono oggetti temporanei disponibili solo per la sessione esplicita o implicita usata da un'applicazione client e vengono eliminati al termine della sessione. È possibile creare oggetti sessione impostando l'attributo Scope del Create comando su Sessione.

Annotazioni

Quando si utilizza l'impostazione Session , l'elemento ObjectDefinition può contenere solo elementi ASSL Dimension, Cube o MiningModel .

Modifica di oggetti

Quando si modificano oggetti utilizzando il Alter metodo , è necessario innanzitutto identificare l'oggetto da modificare fornendo un riferimento all'oggetto nella proprietà Object del Alter comando . Ogni riferimento all'oggetto contiene gli identificatori di oggetto necessari per identificare in modo univoco l'oggetto per il Alter comando. Per altre informazioni sui riferimenti agli oggetti, vedere Definizione e identificazione di oggetti (XMLA).

Ad esempio, è necessario fornire un riferimento a un oggetto a un cubo per modificare la struttura di un cubo. Il riferimento all'oggetto per il cubo nella Object proprietà contiene sia un identificatore di database che un identificatore di cubo, in quanto lo stesso identificatore di cubo potrebbe essere utilizzato in un database diverso.

L'elemento ObjectDefinition contiene elementi ASSL che definiscono l'oggetto principale da modificare. Per altre informazioni su ASSL, vedere Sviluppo con analysis Services Scripting Language (ASSL).

Se si imposta l'attributo AllowCreate del Alter comando su true, è possibile creare l'oggetto principale specificato se l'oggetto non esiste. In caso contrario, si verifica un errore se non esiste già un oggetto principale specificato.

Utilizzo dell'attributo ObjectExpansion

Se si modificano solo le proprietà dell'oggetto principale e non si definiscono oggetti secondari contenuti nell'oggetto principale, è possibile impostare l'attributo ObjectExpansion del Alter comando su ObjectProperties. La ObjectDefinition proprietà deve quindi contenere solo gli elementi per le proprietà dell'oggetto principale e il Alter comando lascia invariati gli oggetti secondari associati all'oggetto principale.

Per ridefinire gli oggetti secondari per un oggetto principale, è necessario impostare l'attributo ObjectExpansion su ExpandFull e la definizione dell'oggetto deve includere tutti gli oggetti secondari contenuti nell'oggetto principale. Se la ObjectDefinition proprietà del Alter comando non include in modo esplicito un oggetto secondario contenuto dall'oggetto principale, l'oggetto secondario non incluso viene eliminato.

Modifica di oggetti sessione

Per modificare gli oggetti sessione creati dal Create comando, impostare l'attributo Scope del Alter comando su Sessione.

Annotazioni

Quando si utilizza l'impostazione Session , l'elemento ObjectDefinition può contenere solo elementi ASSL Dimension, Cube o MiningModel .

Creazione o modifica di oggetti subordinati

Anche se un Create comando o Alter crea o modifica un solo oggetto principale principale, l'oggetto principale da creare o modificare può contenere definizioni all'interno della proprietà di inclusione ObjectDefinition per altri oggetti principali e secondari subordinati. Ad esempio, se si definisce un cubo, si specifica il database padre in ParentObjecte all'interno della definizione del cubo in ObjectDefinition è possibile definire gruppi di misure per il cubo e all'interno dei gruppi di misure è possibile definire partizioni per ogni gruppo di misure. Un oggetto secondario può essere definito solo sotto l'oggetto principale che lo contiene. Per altre informazioni sugli oggetti principali e secondari, vedere Oggetti di database (Analysis Services - Dati multidimensionali).

Esempi

Descrizione

Nell'esempio seguente viene creata un'origine dati relazionale che fa riferimento al database di esempio Di Microsoft SQL Server Adventure Works DW 2012.

Codice

<Create xmlns="https://schemas.microsoft.com/analysisservices/2003/engine">  
    <ParentObject>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
    </ParentObject>  
    <ObjectDefinition>  
        <DataSource xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="RelationalDataSource">  
            <ID>AdventureWorksDW2012</ID>  
            <Name>AdventureWorksDW2012</Name>  
            <ConnectionString>Data Source=localhost;Initial Catalog=AdventureWorksDW2008R2;Integrated Security=True</ConnectionString>  
            <ImpersonationInfo>  
                <ImpersonationMode>ImpersonateServiceAccount</ImpersonationMode>  
            </ImpersonationInfo>  
            <ManagedProvider>System.Data.SqlClient</ManagedProvider>  
            <Timeout>PT0S</Timeout>  
        </DataSource>  
    </ObjectDefinition>  
</Create>  

Descrizione

Nell'esempio seguente viene modificata l'origine dati relazionale creata nell'esempio precedente per impostare il timeout della query per l'origine dati su 30 secondi.

Codice

<Alter ObjectExpansion="ObjectProperties" xmlns="https://schemas.microsoft.com/analysisservices/2003/engine">  
    <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <DataSourceID>AdventureWorksDW2012</DataSourceID>  
    </Object>  
    <ObjectDefinition>  
        <DataSource xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="RelationalDataSource">  
            <ID>AdventureWorksDW2012</ID>  
            <Name>AdventureWorksDW2012</Name>  
            <ConnectionString>Data Source=fr-dwk-02;Initial Catalog=AdventureWorksDW2008R2;Integrated Security=True</ConnectionString>  
            <ManagedProvider>System.Data.SqlClient</ManagedProvider>  
            <Timeout>PT30S</Timeout>  
        </DataSource>  
    </ObjectDefinition>  
</Alter>  

Commenti

L'attributo ObjectExpansionAlter del comando è stato impostato su ObjectProperties. Questa impostazione consente all'elemento ImpersonationInfo , un oggetto secondario, di essere escluso dall'origine dati definita in ObjectDefinition. Pertanto, le informazioni di rappresentazione per tale origine dati rimangono impostate sull'account del servizio, come specificato nel primo esempio.

Vedere anche

Metodo Execute (XMLA)
Sviluppare con il linguaggio di scripting di Analysis Services (ASSL)
Sviluppo con XMLA in Analysis Services