Tarefa Executar DDL do Analysis Services

A tarefa Executar DLL do Serviços de análise executa instruções DDL (linguagem de definição de dados) que podem criar, descartar ou alterar modelos de mineração e objetos multidimensionais, como cubos e dimensões. Por exemplo, uma instrução DDL pode criar uma partição no cubo Adventure Works ou excluir uma dimensão do Adventure Works DW Multidimensional 2012, o exemplo de banco de dados do Serviços de análise incluído no SQL Server.

A tarefa Executar DDL do Serviços de análise usa um gerenciador de conexões do Serviços de análise para se conectar a uma instância do Serviços de análise ou a um projeto do Serviços de análise . Para obter mais informações, consulte Analysis Services Connection Manager.

Integration Services inclui um número de tarefas que desempenham outras operações de business intelligence, como processamento de objetos analíticos e execução de consultas de previsão de mineração de dados.

Para obter mais informações sobre tarefas de business intelligence relacionadas, clique em um dos tópicos a seguir:

• Tarefa Processamento do Analysis Services

• Tarefa Consulta de Mineração de Dados

Instruções DDL

As instruções DDL são representadas como instruções no ASSL (Analysis Services Scripting Language) do Serviços de análise e são enquadradas em um comando XMLA (XML for Analysis).

• O ASSL é usado para definir e descrever uma instância do Serviços de análise e os bancos de dados e objetos de banco de dados que ela contém. Para obter mais informações, consulte Referência da ASSL (Linguagem de Script do Analysis Services).

• O XMLA é uma linguagem de comandos usada para enviar comandos de ação, como Criar, Alterar ou Processar para uma instância do Serviços de análise. Para obter mais informações, confira Referência do XMLA (XML for Analysis).

Se o código DDL for armazenado em um arquivo separado, a tarefa Executar DDL do Serviços de análise usará um gerenciador de conexões de arquivo para especificar o caminho do arquivo. Para obter mais informações, consulte File Connection Manager.

Como as instruções DDL podem conter senhas e outras informações confidenciais, um pacote que contém uma ou mais tarefas Executar DDL do Analysis Services deve usar o nível EncryptAllWithUserKey de proteção do pacote ou EncryptAllWithPassword. Para obter mais informações, confira Pacotes do SSIS (Integration Services).

Exemplos de DDL

As três instruções de DDL a seguir foram geradas por script de objetos no Adventure Works DW Multidimensional 2012, o banco de dados do Serviços de análise incluído no SQL Server.

A instrução DDL a seguir exclui a dimensão Promoção .

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

A instrução de DDL a seguir processa o cubo do Adventure Works DW Multidimensional 2012 .

<Batch xmlns="https://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>  
  

A instrução DDL a seguir cria o modelo de mineração Previsão .

<Create xmlns="https://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>  
  

As três instruções de DDL a seguir foram geradas por script de objetos no Adventure Works DW Multidimensional 2012, o banco de dados do Serviços de análise incluído no SQL Server.

A instrução DDL a seguir exclui a dimensão Promoção .

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

A instrução de DDL a seguir processa o cubo do Adventure Works DW Multidimensional 2012 .

<Batch xmlns="https://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>  
  

A instrução DDL a seguir cria o modelo de mineração Previsão .

<Create xmlns="https://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>  
  

Configuração da Tarefa Executar DDL do Analysis Services

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no SSIS Designer, clique em um dos seguintes tópicos:

• Editor da Tarefa Executar DDL do Analysis Services (página Geral)

• Editor da Tarefa Executar DDL do Analysis Services (Página DDL)

• Página Expressões

Para obter mais informações sobre como definir essas propriedades no SSIS Designer, clique no tópico a seguir:

• Definir as propriedades de uma tarefa ou contêiner

Configuração programática da Tarefa Executar DDL do Analysis Services

Para obter mais informações sobre como definir essas propriedades programaticamente, clique no tópico a seguir:

• ASExecuteDDLTask