Tarefa Executar DDL do Analysis Services

Artigo
05/07/2013

A tarefa Executar DLL do Analysis Services 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 Analysis Services incluído no SQL Server.

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

O 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:

Instruções DDL

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

O ASSL é usado para definir e descrever uma instância do Analysis Services e os bancos de dados e objetos de banco de dados que ela contém. Para obter mais informações, consulte Referência do ASSL (Analysis Services Scripting Language).
O XMLA é uma linguagem de comandos usada para enviar comandos de ação, como Criar, Alterar ou Processar para uma instância do Analysis Services. Para obter mais informações, consulte Referência XMLA (XML for Analysis).

Se o código DDL for armazenado em um arquivo separado, a tarefa Executar DDL do Analysis Services usará um gerenciador de conexões de arquivo para especificar o caminho do arquivo. Para obter mais informações, consulte Gerenciador de conexões de arquivos.

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 de proteção de pacote EncryptAllWithUserKey ou EncryptAllWithPassword. Para obter mais informações, consulte 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 Analysis Services 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 Analysis Services 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 por meio do Designer SSIS ou programaticamente.

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

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

Conteúdo relacionado

Mantenha-se atualizado com o Integration Services

Para obter os downloads, artigos, exemplos e vídeos mais recentes da Microsoft, bem como soluções selecionadas pela comunidade, visite a página do Integration Services no MSDN:

Visite a página do Integration Services no MSDN

Para receber uma notificação automática dessas atualizações, assine os RSS feeds disponíveis na página.

Compartilhar via