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

Статья
05/23/2023

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных 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 Scripting Language (ASSL) и встроены в команду XML для аналитики (XMLA).

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

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

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

Примеры DDL

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

Следующая инструкция 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 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>

Следующая инструкция 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»

Значения свойств можно задавать с помощью конструктора Integration Services или программными средствами.

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

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

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

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

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

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

ASExecuteDDLTask

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

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

Параметры

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

Примечание

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

Описание
Предоставляет описание задачи Execute DDL служб Службы Analysis Services .

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

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

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

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

См. также:Добавление диалогового окна "Диспетчер соединений со службами Analysis Services" в справочнике по пользовательскому интерфейсу, Диспетчер соединений служб Analysis Services

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

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

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

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

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

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

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

См. также:Диспетчер соединения файлов

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

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

См. также:Переменные в службах Integration Services (SSIS)