Partilhar via

Tarefa de Executar DDL do Analysis Services

  • Artigo

se aplica a:SQL Server SSIS Integration Runtime no Azure Data Factory

A tarefa Executar DDL 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 eliminar uma dimensão no Adventure Works DW Multidimensional 2012, o banco de dados de exemplo 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 Analysis Services Connection Manager.

O Integration Services inclui várias tarefas que executam operações de business intelligence, como o processamento de objetos analíticos e a execução de consultas de previsão de mineração de dados.

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

Declarações DDL

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

  • ASSL é usado para definir e descrever uma instância do Analysis Services e os bancos de dados e objetos de banco de dados que ele contém. Para obter mais informações, consulte Analysis Services Scripting Language (ASSL para XMLA).

  • XMLA é uma linguagem de comando 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 XML for Analysis (XMLA) Reference.

Se o código DDL estiver 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 Gestor de Conexões de Arquivo.

Como as instruções DDL podem conter senhas e outras informações confidenciais, um pacote que inclua uma ou mais tarefas de execução DDL dos Analysis Services deve utilizar o nível de proteção EncryptAllWithUserKey ou EncryptAllWithPassword. Para obter mais informações, consulte Pacotes de Serviços de Integração (SSIS).

Exemplos de DDL

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

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

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

A instrução DDL a seguir processa o 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>

A instrução DDL a seguir cria o modelo de mineração de previsões .

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

As três instruções DDL a seguir foram geradas por objetos de script 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="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <DimensionID>Dim Promotion</DimensionID>  
    </Object>  
</Delete>

A instrução DDL a seguir processa o 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>

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

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

Configuração da tarefa de execução de DDL do Analysis Services

Você pode definir propriedades por meio do SSIS Designer ou programaticamente.

Para obter mais informações sobre as propriedades que você pode definir no Designer SSIS, clique no seguinte tópico:

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

Configuração programática da tarefa de execução de DDL no Analysis Services

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

Editor de Execução de Tarefa DDL do Analysis Services (Página Geral)

Use a página Geral da caixa de diálogo Editor de Tarefas Executar DDL do Analysis Services para nomear e descrever a tarefa Executar DDL do Analysis Services.

Opções

Nome
Forneça um nome exclusivo para a tarefa Executar DDL do Analysis Services. Esse nome é usado como o rótulo no ícone da tarefa.

Observação

Os nomes das tarefas devem ser exclusivos dentro de um pacote.

Descrição
Escreva uma descrição da tarefa Executar DDL do Analysis Services.

Editor de Execução de Tarefas DDL do Analysis Services (Página DDL)

Use a página DDL da caixa de diálogo Editor de Tarefas Executar DDL do Analysis Services para especificar uma conexão com um projeto do Analysis Services ou um banco de dados do Analysis Services e para fornecer informações sobre a fonte das instruções de linguagem de definição de dados (DDL).

Opções estáticas

Conexão
Selecione um projeto do Analysis Services ou um gerenciador de conexões do Analysis Services na lista ou clique em <Nova conexão...> e use a caixa de diálogo Adicionar Gerenciador de Conexões do Analysis Services para criar uma nova conexão.

Tópicos relacionados:Referência da interface de utilizador da caixa de diálogo Adicionar Gerenciador de Conexões do Analysis Services, Gerenciador de Conexões do Analysis Services

SourceType
Especifique o tipo de origem das instruções DDL. Esta propriedade tem as opções listadas na tabela a seguir:

Valor Descrição
de entrada direta Defina a origem como a instrução DDL armazenada na caixa de texto SourceDirect. A seleção desse valor exibe as opções dinâmicas na seção a seguir.
Conexão de Ficheiro Defina a origem como um arquivo que contenha a instrução DDL. A seleção desse valor exibe as opções dinâmicas na seção a seguir.
Variável Defina a origem como uma variável. A seleção desse valor exibe as opções dinâmicas na seção a seguir.

Opções dinâmicas

SourceType = Entrada direta

Fonte
Digite as instruções DDL ou clique nas reticências (...) e, em seguida, digite as instruções na caixa de diálogo Instruções DDL .

TipoDeFonte = Conexão de arquivo

de origem
Selecione uma conexão de arquivo na lista ou clique em Nova conexão... e use a caixa de diálogo Gerenciador de Conexões de Arquivo para criar uma nova conexão.

Tópicos relacionados:Gestor de Conexão de Ficheiros

SourceType = Variável

Fonte
Selecione uma variável na lista ou clique em <Nova variável...> e use a caixa de diálogo Adicionar variável para criar uma nova variável.

Tópicos Relacionados:Variáveis do Integration Services (SSIS)