共用方式為

Analysis Services 執行 DDL 工作

  • 發行項

適用於：SQL Server Azure Data Factory 中的 SSIS Integration Runtime

Analysis Services 執行 DDL 工作會執行可建立、卸除或更改採礦模型和多維度物件 (例如 Cube 和維度) 的資料定義語言 (DDL) 陳述式。 例如，DDL 陳述式可在 Adventure Works Cube 中建立分割區，或在 Adventure Works DW Multidimensional 2012 (SQL Server 中包含的範例 Analysis Services 資料庫) 中刪除維度。

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 是一種命令語言，用來將動作命令 (例如 Create、Alter 或 Process) 傳送至 Analysis Services 的執行個體。 如需詳細資訊，請參閱 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 (SQL Server 中包含的 Analysis Services 資料庫) 中的指令碼物件所產生。

下列 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 Cube。

<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 陳述式會建立 預測 採礦模型。

<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 (SQL Server 中包含的 Analysis Services 資料庫) 中的指令碼物件所產生。

下列 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 Cube。

<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 陳述式會建立 預測 採礦模型。

<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 Designer 中設定這些屬性的詳細資訊，請點選下列主題：

以程式設計方式設定 Analysis Services 執行 DDL 工作

如需有關以程式設計方式設定這些屬性的詳細資訊，請按下列主題：

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) 陳述式來源的相關資訊。

靜態選項

[連接]
選取清單中的 Analysis Services 專案或 Analysis Services 連線管理員，或是按一下 [<新增連線...>] 並使用 [新增 Analysis Services 連線管理員] 對話方塊，即可建立新的連線。

相關主題：加入 Analysis Services 連線管理員對話方塊 UI 參考、Analysis Services 連線管理員

SourceType
指定 DDL 陳述式的來源類型。 此屬性具有下表所列的選項：

值 描述
直接輸入 將來源設定為 [SourceDirect] 文字方塊中所儲存的 DDL 陳述式。 選取這個值就會顯示在下列章節中的動態選項。
檔案連接 將來源設定為包含 DDL 陳述式的檔案。 選取這個值就會顯示在下列章節中的動態選項。
變數 將來源設定為變數。 選取這個值就會顯示在下列章節中的動態選項。

動態選項

SourceType = 直接輸入

Source
鍵入 DDL 陳述式或按一下省略符號 (...) ，然後在 [DDL 陳述式] 對話方塊中鍵入陳述式。

SourceType = 檔案連接

Source
選取清單中的檔案連線，或是按一下 [<新增連線...>] 並使用 [檔案連線管理員] 對話方塊，即可建立新的連線。

相關主題：檔案連線管理員

SourceType = 變數

Source
選取清單中的變數，或是按一下 [<新增變數...>] 並使用 [新增變數] 對話方塊，即可建立新的變數。

相關主題：整合服務 (SSIS) 變數