Tarea Ejecutar DDL de Analysis Services

Artículo
05/23/2023

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

La tarea Ejecutar DDL de Analysis Services ejecuta instrucciones del lenguaje de definición de datos (DDL) que pueden crear, quitar o modificar modelos de minería de datos y objetos multidimensionales, como cubos y dimensiones. Por ejemplo, una instrucción DDL puede crear una partición en el cubo de Adventure Works o eliminar una dimensión de Adventure Works DW Multidimensional 2012, la base de datos de ejemplo de Analysis Services incluida en SQL Server.

La tarea Ejecutar DDL de Analysis Services utiliza un administrador de conexiones de Analysis Services para conectar con una instancia de Analysis Services o un proyecto de Analysis Services . Para más información, consulte Analysis Services Connection Manager.

Integration Services incluye diversas tareas que realizan operaciones de Business Intelligence, como procesamiento de objetos de análisis y la ejecución de consultas de predicción de minería de datos.

Para obtener más información sobre tareas de Business Intelligence relacionadas, haga clic en uno de los temas siguientes:

Instrucciones DDL

Las instrucciones de DDL se representan como instrucciones del Lenguaje de scripting de Analysis Services (ASSL) y se generan como comandos de XML for Analysis (XMLA).

ASSL se usa para definir y describir una instancia de Analysis Services , así como las bases de datos y los objetos de base de datos que contiene. Para más información, vea Referencia de Analysis Services Scripting Language (ASSL).
XMLA es un lenguaje de comandos que se usa para enviar comandos de acción, como Create, Alter o Process, a una instancia de Analysis Services. Para más información, vea Referencia XML for Analysis (XMLA).

Si se almacena el código de DDL en un archivo independiente, la tarea Ejecutar DDL de Analysis Services utiliza un administrador de conexiones de archivos para especificar la ruta del archivo. Para obtener más información, consulte File Connection Manager.

Como las instrucciones de DDL pueden contener contraseñas y otra información confidencial, un paquete que contenga una o varias tareas Ejecutar DDL de Analysis Services debe usar el nivel de protección de paquetes EncryptAllWithUserKey o EncryptAllWithPassword. Para más información, consulte Paquetes de Integration Services (SSIS) Packages.

Ejemplos de DDL

Las tres instrucciones DDL siguientes se generaron mediante objetos de scripting de Adventure Works DW Multidimensional 2012, la base de datos de Analysis Services incluida en SQL Server.

La siguiente instrucción DDL elimina la dimensión Promotion .

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

La siguiente instrucción DDL procesa el cubo de 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>

La siguiente instrucción DDL crea el modelo de minería 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>

Las tres instrucciones DDL siguientes se generaron mediante objetos de scripting de Adventure Works DW Multidimensional 2012, la base de datos de Analysis Services incluida en SQL Server.

La siguiente instrucción DDL elimina la dimensión Promotion .

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

La siguiente instrucción DDL procesa el cubo de 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>

La siguiente instrucción DDL crea el modelo de minería 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>

Configuración de la tarea Ejecutar DDL de Analysis Services

Puede establecer propiedades a través del Diseñador de SSIS o mediante programación.

Para obtener más información acerca de las propiedades que puede establecer en el Diseñador SSIS , haga clic en el tema siguiente:

Página Expresiones

Para obtener más información sobre cómo configurar estas propiedades en el Diseñador SSIS , haga clic en el siguiente tema:

Establecer las propiedades de tareas o contenedores

Configuración mediante programación de la tarea Ejecutar DDL de Analysis Services

Para obtener más información sobre cómo establecer estas propiedades mediante programación, haga clic en el tema siguiente:

ASExecuteDDLTask

Editor de la tarea Ejecutar DDL de Analysis Services (página General)

Use la página General del cuadro de diálogo Editor de la tarea Ejecutar DDL de Analysis Services para nombrar y describir la tarea Ejecutar DDL de Analysis Services .

Opciones

Nombre
Proporcione un nombre único para la tarea Ejecutar DDL de Analysis Services . Este nombre se utiliza como etiqueta en el icono de tarea.

Nota

Los nombres de tarea deben ser únicos en un paquete.

Descripción
Escriba una descripción de la tarea Ejecutar DDL de Analysis Services .

Editor de la tarea Ejecutar DDL de Analysis Services (página DDL)

Use la página DDL del cuadro de diálogo Editor de la tarea Ejecutar DDL de Analysis Services para especificar una conexión a un proyecto de Analysis Services o una base de datos de Analysis Services y proporcionar información sobre el origen de las instrucciones del lenguaje de definición de datos (DDL).

Opciones estáticas

Connection
Seleccione un proyecto de Analysis Services o un administrador de conexiones de Analysis Services en la lista, o bien haga clic en <Nueva conexión...> y use el cuadro de diálogo Agregar administrador de conexiones de Analysis Services para crear una conexión.

Temas relacionados:Referencia de la interfaz de usuario del cuadro de diálogo Agregar administrador de conexiones con Analysis Services, Administrador de conexiones de Analysis Services

Tipo de origen
Especifique el tipo de origen de las instrucciones de DDL. Esta propiedad presenta las opciones indicadas en la siguiente tabla:

Value	Descripción
Entrada directa	Establezca en el cuadro de texto SourceDirect el origen de la instrucción DDL almacenada. Al seleccionar este valor se muestran las opciones dinámicas de la siguiente sección.
Conexión de archivos	Establezca el origen de un archivo que contenga la instrucción DDL. Al seleccionar este valor se muestran las opciones dinámicas de la siguiente sección.
Variable	Establezca el origen en una variable. Al seleccionar este valor se muestran las opciones dinámicas de la siguiente sección.

Opciones dinámicas

SourceType = Entrada directa

Origen
Escriba las instrucciones de DDL, o bien haga clic en el botón de puntos suspensivos (…) y, después, escriba las instrucciones en el cuadro de diálogo Instrucciones DDL.

SourceType = Conexión de archivos

Origen
Seleccione una conexión de archivos de la lista, o bien haga clic en <Nueva conexión…> y use el cuadro de diálogo Administrador de conexiones de archivos para crear una conexión.

Temas relacionados:Administrador de conexiones de archivos

SourceType = Variable

Origen
Seleccione una variable de la lista, o bien haga clic en <Nueva variable...> y use el cuadro de diálogo Agregar variable para crear una variable.

Temas relacionados:Variables de Integration Services (SSIS)