Attività Esegui DDL Analysis Services

Articolo
05/23/2023

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

L'attività Esegui DDL Analysis Services consente di eseguire istruzioni DDL (Data Definition Language) in grado di creare, eliminare o modificare modelli di data mining e oggetti multidimensionali, quali cubi e dimensioni. Tramite un'istruzione DDL è ad esempio possibile creare una partizione nel cubo Adventure Works oppure eliminare una dimensione in Adventure Works DW Multidimensional 2012, il database di esempio di Analysis Services incluso in SQL Server.

L'attività Esegui DDL Analysis Services utilizza una gestione connessione di Analysis Services per connettersi a un'istanza di Analysis Services o a un progetto Analysis Services. Per altre informazioni, vedere Gestione connessione Analysis Services.

Integration Services include numerose attività che eseguono operazioni di Business Intelligence, ad esempio l'elaborazione di oggetti di analisi e l'esecuzione di query di stima basate su modelli di data mining.

Per ulteriori informazioni sulle attività di Business Intelligence correlate, fare clic su uno degli argomenti seguenti:

Istruzioni DDL

Le istruzioni DDL sono rappresentate come istruzioni in ASSL (Analysis Services Scripting Language) e inserite nell'ambito di un comando XMLA (XML for Analysis).

Il linguaggio ASSL consente di definire e descrivere un'istanza di Analysis Services, nonché dei database e degli oggetti di database contenuti. Per altre informazioni, vedere Guida di riferimento ad Analysis Services Scripting Language (ASSL per XMLA).
XMLA è un linguaggio di comando che consente di inviare a un'istanza di Analysis Services comandi di azione quali Create, Alter o Process. Per altre informazioni, vedere Guida di riferimento a XML for Analysis (XMLA).

Se il codice DDL è archiviato in un file separato, l'attività Esegui DDL Analysis Services userà una gestione connessione file per specificare il percorso del file. Per altre informazioni, vedere File Connection Manager.

Poiché le istruzioni DDL possono contenere password e altre informazioni sensibili, per i pacchetti che contengono una o più attività Esegui DDL Analysis Services è necessario usare il livello di protezione del pacchetto EncryptAllWithUserKey o EncryptAllWithPassword. Per altre informazioni, vedere Pacchetti di Integration Services (SSIS).

Esempi di DDL

Le tre istruzioni DDL seguenti sono state generate da oggetti di scripting in Adventure Works DW Multidimensional 2012, il database di Analysis Services incluso in SQL Server.

L'istruzione DDL seguente elimina la dimensione Promotion .

<Delete xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <DimensionID>Dim Promotion</DimensionID>  
    </Object>  
</Delete>

L'istruzione DDL seguente elabora il cubo Adventure Works DW Multidimensional 2012.

<Batch xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
  <Parallel>  
    <Process xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
      <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
      </Object>  
      <Type>ProcessFull</Type>  
      <WriteBackTableCreation>UseExisting</WriteBackTableCreation>  
    </Process>  
  </Parallel>  
</Batch>

L'istruzione DDL seguente crea il modello di data mining Forecasting .

<Create xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <ParentObject>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <MiningStructureID>Forecasting</MiningStructureID>  
    </ParentObject>  
    <ObjectDefinition>  
        <MiningModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
            <ID>Forecasting</ID>  
            <Name>Forecasting</Name>  
            <Algorithm>Microsoft_Time_Series</Algorithm>  
            <AlgorithmParameters>  
                <AlgorithmParameter>  
                    <Name>PERIODICITY_HINT</Name>  
                    <Value xsi:type="xsd:string">{12}</Value>  
                </AlgorithmParameter>  
            </AlgorithmParameters>  
            <Columns>  
                <Column>  
                    <ID>Amount</ID>  
                    <Name>Amount</Name>  
                    <SourceColumnID>Amount</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Model Region</ID>  
                    <Name>Model Region</Name>  
                    <SourceColumnID>Model Region</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
                <Column>  
                    <ID>Quantity</ID>  
                    <Name>Quantity</Name>  
                    <SourceColumnID>Quantity</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Time Index</ID>  
                    <Name>Time Index</Name>  
                    <SourceColumnID>Time Index</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
            </Columns>  
            <Collation>Latin1_General_CS_AS_KS</Collation>  
        </MiningModel>  
    </ObjectDefinition>  
</Create>

Le tre istruzioni DDL seguenti sono state generate da oggetti di scripting in Adventure Works DW Multidimensional 2012, il database di Analysis Services incluso in SQL Server.

L'istruzione DDL seguente elimina la dimensione Promotion .

<Delete xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <DimensionID>Dim Promotion</DimensionID>  
    </Object>  
</Delete>

L'istruzione DDL seguente elabora il cubo Adventure Works DW Multidimensional 2012.

<Batch xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
  <Parallel>  
    <Process xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
      <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
      </Object>  
      <Type>ProcessFull</Type>  
      <WriteBackTableCreation>UseExisting</WriteBackTableCreation>  
    </Process>  
  </Parallel>  
</Batch>

L'istruzione DDL seguente crea il modello di data mining Forecasting .

<Create xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <ParentObject>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <MiningStructureID>Forecasting</MiningStructureID>  
    </ParentObject>  
    <ObjectDefinition>  
        <MiningModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
            <ID>Forecasting</ID>  
            <Name>Forecasting</Name>  
            <Algorithm>Microsoft_Time_Series</Algorithm>  
            <AlgorithmParameters>  
                <AlgorithmParameter>  
                    <Name>PERIODICITY_HINT</Name>  
                    <Value xsi:type="xsd:string">{12}</Value>  
                </AlgorithmParameter>  
            </AlgorithmParameters>  
            <Columns>  
                <Column>  
                    <ID>Amount</ID>  
                    <Name>Amount</Name>  
                    <SourceColumnID>Amount</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Model Region</ID>  
                    <Name>Model Region</Name>  
                    <SourceColumnID>Model Region</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
                <Column>  
                    <ID>Quantity</ID>  
                    <Name>Quantity</Name>  
                    <SourceColumnID>Quantity</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Time Index</ID>  
                    <Name>Time Index</Name>  
                    <SourceColumnID>Time Index</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
            </Columns>  
            <Collation>Latin1_General_CS_AS_KS</Collation>  
        </MiningModel>  
    </ObjectDefinition>  
</Create>

Configurazione dell'attività Esegui DDL Analysis Services

È possibile impostare le proprietà tramite Progettazione SSIS o a livello di codice.

Per altre informazioni sulle proprietà che è possibile impostare in Progettazione SSIS, fare clic sull'argomento seguente:

Pagina Espressioni

Per ulteriori informazioni sull'impostazione di queste proprietà in Progettazione SSIS, fare clic sull'argomento seguente:

Impostazione delle proprietà di un'attività o di un contenitore

Configurazione dell'attività Esegui DDL Analysis Services a livello di codice

Per ulteriori informazioni sull'impostazione di queste proprietà a livello di codice, fare clic sull'argomento seguente:

ASExecuteDDLTask

Editor attività Esegui DDL Analysis Services (pagina Generale)

Usare la pagina Generale della finestra di dialogo Editor attività Esegui DDL Analysis Services per assegnare un nome e una descrizione all'attività Esegui DDL Analysis Services.

Opzioni

Nome
Consente di specificare un nome univoco per l'attività Esegui DDL Analysis Services. Tale nome viene utilizzato come etichetta nell'icona dell'attività.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.

Descrizione
Digitare una descrizione dell'attività Esegui DDL Analysis Services.

Editor attività Esegui DDL Analysis Services (pagina DDL)

La pagina DDL della finestra di dialogo Editor attività Esegui DDL Analysis Services consente di specificare una connessione a un progetto di Analysis Services o a un database di Analysis Services per offrire informazioni sull'origine delle istruzioni DDL (Data Definition Language).

Opzioni statiche

Connessione
Selezionare un progetto di Analysis Services o una gestione connessione Analysis Services dall'elenco oppure fare clic su <Nuova connessione...> e usare la finestra di dialogo Aggiungi gestione connessione Analysis Services per creare una nuova connessione.

Argomenti correlati:Riferimento all'interfaccia utente della finestra di dialogo Aggiungi gestione connessione Analysis Services, Gestione connessione Analysis Services

SourceType
Consente di specificare il tipo di origine delle istruzioni DDL. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente:

Valore	Descrizione
Direct Input	Consente di impostare l'origine sull'istruzione DDL archiviata nella casella di testo SourceDirect . Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche illustrate nella sezione seguente.
File Connection	Consente di impostare l'origine su un file contenente l'istruzione DDL. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche illustrate nella sezione seguente.
Variabile	Consente di impostare l'origine su una variabile. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche illustrate nella sezione seguente.

Opzioni dinamiche

SourceType = Direct Input

Origine
Digitare le istruzioni DDL o fare clic sul pulsante con i puntini di sospensione (...) e quindi digitare le istruzioni nella finestra di dialogo Istruzioni DDL.

SourceType = File Connection

Origine
Selezionare una connessione file dall'elenco oppure fare clic su <Nuova connessione...> e usare la finestra di dialogo Gestione connessione file per creare una nuova connessione.

Argomenti correlati:Gestione connessione file

SourceType = Variable

Origine
Selezionare una variabile dall'elenco oppure fare clic su <Nuova variabile...> e usare la finestra di dialogo Aggiungi variabile per creare una nuova variabile.

Argomenti correlati:Variabili di Integration Services (SSIS)