Задача «Выполнение инструкции DDL служб Analysis Services»

Статья
07/04/2024

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

Задача выполнения DDL служб Analysis Services выполняет инструкции языка определения данных (DDL), которые могут создавать, удалять или изменять модели интеллектуального анализа данных и многомерные объекты, такие как кубы и измерения. Например, инструкция DDL может создать секцию в кубе Adventure Works или удалить измерение в Adventure Works DW Multidimensional 2012, образец базы данных Analysis Services, включенной в SQL Server.

Задача "Выполнение DDL служб Analysis Services" использует диспетчер соединений служб Analysis Services для подключения к экземпляру служб Analysis Services или проекту служб Analysis Services. Дополнительные сведения см. в статье Analysis Services Connection Manager.

Службы Integration Services включают ряд задач, выполняющих операции бизнес-аналитики, такие как обработка аналитических объектов и выполнение запросов прогнозирования интеллектуального анализа данных.

Дополнительные сведения о задачах, связанных с бизнес-аналитикой, см. в следующих разделах:

Инструкции DDL

Инструкции DDL представлены в виде инструкций в языке сценариев служб Analysis Services (ASSL) и обрамлены в команде XML для анализа (XMLA).

ASSL используется для определения и описания экземпляра служб Analysis Services и баз данных и объектов базы данных, содержащихся в ней. Дополнительные сведения см. в разделе Язык скриптов для Analysis Services (ASSL для XMLA).
XMLA — это язык команд, используемый для отправки команд действий, таких как Create, Alter или Process, в экземпляр служб Analysis Services. Дополнительные сведения см. в разделе Справочник по XML для аналитики (XMLA).

Если код DDL хранится в отдельном файле, задача "Выполнение DDL служб Analysis Services" использует диспетчер соединений файлов для указания пути к файлу. Дополнительные сведения см. в статье File Connection Manager.

Так как инструкции DDL могут содержать пароли и другие конфиденциальные сведения, пакет, содержащий одну или несколько задач DDL служб Analysis Services Execute, должен использовать уровень защиты пакета EncryptAllWithUserKey или EncryptAllWithWithPassword. Дополнительные сведения см. в разделе Пакеты служб Integration Services (SSIS).

Примеры DDL

Следующие три инструкции DDL были созданы объектами скриптов в многомерном хранилище adventure Works 2012, базой данных Analysis Services, включенной в SQL Server.

Следующая инструкция DDL удаляет измерение Promotion .

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

Следующая инструкция DDL обрабатывает многомерный куб Adventure Works DW 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>

Следующая инструкция DDL создает модель интеллектуального анализа данных 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>

Следующая инструкция DDL удаляет измерение Promotion .

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

Следующая инструкция DDL обрабатывает многомерный куб Adventure Works DW 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>

Следующая инструкция DDL создает модель интеллектуального анализа данных 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>

Настройка задачи «Выполнение инструкции DDL служб Analysis Services»

Свойства могут быть заданы с помощью конструктора SSIS или программным путем.

Дополнительные сведения о свойствах, которые можно задать в конструкторе служб SSIS, щелкните следующий раздел:

Страница «Выражения»

Дополнительные сведения о настройке этих свойств в конструкторе служб SSIS см. в следующем разделе:

Задание свойств задач или контейнеров

Программная настройка задачи «Выполнение инструкции DDL служб Analysis Services»

Дополнительные сведения об установке этих свойств программными средствами см. в следующем разделе.

ASExecuteDDLTask

Редактор задачи «Выполнение инструкции DDL служб Analysis Services» (страница «Общие»)

Используйте диалоговое окно "Общие " в диалоговом окне редактора задач "Выполнение DDL служб Analysis Services" и описание задачи "Выполнение DDL служб Analysis Services".

Параметры

Имя
Укажите уникальное имя для задачи выполнения DDL служб Analysis Services. Это имя используется в качестве метки для значка задачи.

Примечание.

Имена задач в пределах пакета должны быть уникальными.

Description
Введите описание задачи выполнения DDL служб Analysis Services.

Редактор задачи «Выполнение инструкции DDL служб Analysis Services» (страница DDL)

Используйте страницу DDL диалогового окна редактора задач "Выполнение DDL служб Analysis Services", чтобы указать подключение к проекту служб Analysis Services или базе данных Analysis Services и предоставить сведения о источнике инструкций языка определения данных (DDL).

Статические параметры

Соединение
Выберите проект Службы Analysis Services или диспетчер подключений Службы Analysis Services в списке или щелкните <Создать соединение...>и создайте подключение с помощью диалогового окна Добавление диспетчера соединений со службами Analysis Services.

Связанные разделы: добавление справочника по пользовательскому интерфейсу диспетчер подключений служб Analysis Services диспетчер подключений, службам Analysis Services диспетчер подключений

Тип источника
Указать тип источника инструкции DDL. Параметры этого свойства приведены в следующей таблице.

значение	Описание
Прямой ввод	Установите в качестве источника инструкцию DDL, содержащуюся в текстовом поле SourceDirect . При выборе этого значения в следующем подразделе отображаются динамические параметры.
Соединение с файлом	В качестве источника указывается файл, содержащий инструкцию DDL. При выборе этого значения в следующем подразделе отображаются динамические параметры.
Переменная	Установите в качестве источника переменную. При выборе этого значения в следующем подразделе отображаются динамические параметры.

Динамические параметры

SourceType = Прямой ввод

Источник
Введите инструкции DDL или нажмите кнопку с многоточием (…) и после этого введите инструкции в диалоговом окне Инструкции DDL.

SourceType = Подключение файла

Источник
Выберите "Соединение с файлом" из списка или нажмите кнопку <Создать соединение...> и создайте новое соединение с помощью диалогового окна Диспетчер соединения файлов.

Связанные разделы: диспетчер подключений файлов

SourceType = Переменная

Источник
Выберите переменную из списка или нажмите <Создать переменную...> и создайте новую переменную с помощью диалогового окна Добавить переменную.

Связанные разделы: переменные служб Integration Services (SSIS)

Поделиться через