Analysis Services 执行 DDL 任务

项目
05/23/2023

适用于： SQL Server Azure 数据工厂中的 SSIS Integration Runtime

“ Analysis Services 执行 DDL”任务运行数据定义语言 (DDL) 语句，这些语句可以创建、删除或更改挖掘模型和多维对象，如多维数据集和维度。例如，DDL 语句可在 Adventure Works 多维数据集中创建分区，或删除 Adventure Works DW Multidimensional 2012（即 Analysis Services 中包含的示例 SQL Server数据库）中的维度。

“ Analysis Services 执行 DDL”任务使用 Analysis Services 连接管理器连接到 Analysis Services 实例或 Analysis Services 项目。有关详细信息，请参阅 Analysis Services Connection Manager。

Integration Services 包含许多执行商业智能操作（如处理分析对象和运行数据挖掘预测查询）的任务。

有关相关商业智能任务的详细信息，请单击以下主题之一：

DDL 语句

DDL 语句表示为 Analysis Services 脚本语言 (ASSL) 中的语句，并且嵌入 XML for Analysis (XMLA) 命令中。

ASSL 用于定义和说明 Analysis Services 实例及其包含的数据库和数据库对象。有关详细信息，请参阅 Analysis Services 脚本语言 (ASSL for XMLA)。
XMLA 是用于向 Analysis Services实例发送操作命令（如 Create、Alter 或 Process）的命令语言。有关详细信息，请参阅 XML for Analysis (XMLA) 参考。

如果 DDL 代码存储在单独的文件中，则“ Analysis Services 执行 DDL”任务使用文件连接管理器来指定该文件的路径。有关详细信息，请参阅 File Connection Manager。

因为 DDL 语句可以包含密码和其他敏感信息，所以包含一个或多个“ Analysis Services 执行 DDL”任务的包应该使用包保护级别 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 语句是通过对 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>

“Analysis Services 执行 DDL”任务的配置

可以通过 SSIS 设计器或以编程方式来设置属性。

有关可在 SSIS 设计器中设置的属性的详细信息，请单击以下主题：

“表达式”页

有关在 SSIS 设计器中设置这些属性的详细信息，请单击以下主题：

设置任务或容器的属性

“Analysis Services 执行 DDL”任务的编程配置

有关以编程方式设置这些属性的详细信息，请单击以下主题：

ASExecuteDDLTask

Analysis Services 执行 DDL 任务编辑器（“常规”页）

可以使用“Analysis Services 执行 DDL 任务编辑器” 对话框的“常规” 页命名和描述 Analysis Services 执行 DDL 任务。

选项

名称
为 Analysis Services 执行 DDL 任务提供唯一的名称。此名称用作任务图标中的标签。

注意

任务名称在一个包内必须是唯一的。

说明
键入对 Analysis Services 执行 DDL 任务的说明。

Analysis Services 执行 DDL 任务编辑器（DDL 页）

可以使用“Analysis Services 执行 DDL 任务编辑器”对话框的 DDL 页指定与 Analysis Services 项目或 Analysis Services 数据库的连接，以及提供有关数据定义语言 (DDL) 语句的源的信息。

静态选项

Connection
在列表中选择 Analysis Services 项目或 Analysis Services 连接管理器，或者单击“<新建连接...>”并使用“添加 Analysis Services 连接管理器”对话框创建新的连接。

SourceType
指定 DDL 语句的源类型。此属性具有下表所列的选项：

值	说明
直接输入	将源设置为 SourceDirect 文本框中存储的 DDL 语句。选择此值将显示以下部分中的动态选项。
文件连接	将源设置为包含 DDL 语句的文件。选择此值将显示以下部分中的动态选项。
变量	将源设置为变量。选择此值将显示以下部分中的动态选项。

动态选项

SourceType = 直接输入

数据源
键入 DDL 语句，或单击省略号 (…)，然后在“DDL 语句”对话框中键入语句。

SourceType = 文件连接

数据源
在列表中选择“文件连接”，或单击“<新建连接...>”并使用“文件连接管理器”对话框新建一个连接。

相关主题：文件连接管理器

SourceType = 变量

数据源
在列表中选择一个变量，或单击“<新建变量...>”并使用“添加变量”对话框新建一个变量。

相关主题：Integration Services (SSIS) 变量

通过