Tarefa Executar DDL do Analysis Services

Artigo
05/23/2023

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

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:

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, confira Linguagem de script do Analysis Services (ASSL para XMLA).
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 Serviços de análise deve usar o nível de proteção de pacote EncryptAllWithUserKey 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="http://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="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 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>

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="http://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="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 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 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 no tópico a seguir:

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

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

Use a página Geral da caixa de diálogo Editor da Tarefa Executar DDL do Analysis Services para nomear e descrever a tarefa Executar DDL do Serviços de análise .

Opções

Nome
Forneça um nome exclusivo para a tarefa Executar DDL do Serviços de análise . Esse nome é usado como rótulo no ícone de tarefa.

Observação

Os nomes das tarefas devem ser exclusivos em um pacote.

Descrição
Digite uma descrição para a tarefa Executar DDL do Serviços de análise .

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

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

Opções estáticas

Conexão
Selecione um projeto Serviços de Análise ou um gerenciador de conexões Serviços de Análise 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 conexão.

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

SourceType
Especifique a origem da instrução DDL. As opções desta propriedade estão listadas na seguinte tabela:

Valor	Descrição
Direct Input	Define a origem da instrução DDL armazenada na caixa de texto SourceDirect . A seleção deste valor exibe as opções dinâmicas na seção a seguir.
File Connection	Define a origem para um arquivo que contém a instrução DDL. A seleção deste valor exibe as opções dinâmicas na seção a seguir.
Variável	Define a origem para uma variável. A seleção deste valor exibe as opções dinâmicas na seção a seguir.

Opções dinâmicas

SourceType = Entrada Direta

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

SourceType = File Connection

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 Arquivos para criar uma nova conexão.

Tópicos relacionados: Gerenciador de Conexões de Arquivos

SourceType = Variable

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

Partilhar via