Analysis Services DDL 実行タスク

[アーティクル]
05/23/2023

適用対象: SQL Server Azure Data Factory の SSIS Integration Runtime

Analysis Services DDL 実行タスクは、データ定義言語 (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 接続マネージャー」をご覧ください。

Integration Services には、分析オブジェクトの処理やデータマイニング予測クエリの実行など、ビジネスインテリジェンス操作を実行する多数のタスクが含まれます。

関連するビジネスインテリジェンスタスクの詳細については、次のトピックのいずれかを参照してください。

DDL ステートメント

DDL ステートメントは、 Analysis Services スクリプト言語 (ASSL) のステートメントとして表され、XML for Analysis (XMLA) コマンドで構成されます。

ASSL は、 Analysis Services のインスタンス、それに含まれるデータベースやデータベースオブジェクトの定義、および記述に使用されます。詳細については、「Analysis Services スクリプト言語 (XMLA 用 ASSL)」を参照してください。
XMLA は、Create、Alter、Process などのアクションコマンドを、 Analysis Servicesのインスタンスに送信する場合に使用されるコマンド言語です。詳細については、「XML for Analysis (XMLA) リファレンス」を参照してください。

DDL コードが別のファイルに格納されている場合、 Analysis Services DDL 実行タスクはファイル接続マネージャーを使用して、そのファイルのパスを指定します。詳しくは「 File Connection Manager」をご覧ください。

DDL ステートメントには、パスワードおよびその他の機微な情報が含まれる場合があるため、1 つ以上の Analysis Services DDL 実行タスクが含まれるパッケージでは、パッケージの保護レベル EncryptAllWithUserKey または EncryptAllWithPasswordを使用する必要があります。詳細については、「Integration Services (SSIS) パッケージ」を参照してください。

DDL の例

次の 3 つの 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>

Analysis Services DDL 実行タスクの構成

プロパティを設定するには SSIS デザイナーから行うか、またはプログラムによって設定します。

SSIS デザイナーで設定できるプロパティの詳細については、次のトピックを参照してください。

[式] ページ

SSIS デザイナーでこれらのプロパティを設定する方法については、次のトピックをクリックしてください。

タスクまたはコンテナーのプロパティを設定する

プログラムによる Analysis Services DDL 実行タスクの構成

プログラムによってこれらのプロパティを設定する方法の詳細については、次のトピックを参照してください。

ASExecuteDDLTask

[Analysis Services DDL 実行タスクエディター] ([全般] ページ)

[Analysis Services DDL 実行タスクエディター] ダイアログボックスの [全般] ページを使用すると、 Analysis Services DDL 実行タスクの名前と説明を入力できます。

Options

名前
Analysis Services DDL 実行タスクの一意な名前を指定します。この名前は、タスクアイコンのラベルとして使用されます。

Note

タスク名はパッケージ内で一意である必要があります。

説明
Analysis Services DDL 実行タスクの説明を入力します。

[Analysis Services DDL 実行タスクエディター] ([DDL] ページ)

[Analysis Services DDL 実行タスクエディター] ダイアログボックスの [DDL] ページを使用すると、 Analysis Services プロジェクトまたは Analysis Services データベースへの接続を指定でき、データ定義言語 (DDL) ステートメントのソースについての情報を表示できます。

静的オプション

接続
Analysis Services プロジェクトまたは Analysis Services 接続マネージャーを一覧で選択するか、<[新しい接続...]> をクリックし、[Analysis Services 接続マネージャーの追加] ダイアログボックスを使用して、新しい接続を作成します。

[SourceType]
DDL ステートメントのソースの種類を指定します。このプロパティには、次の表に示すオプションがあります。

値	説明
[直接入力]	[SourceDirect] テキストボックスに格納される DDL ステートメントへのソースを設定します。この値を選択すると、次に示す動的オプションが表示されます。
[ファイル接続]	DDL ステートメントを含むファイルへのソースを設定します。この値を選択すると、次に示す動的オプションが表示されます。
変数	ソースを変数に設定します。この値を選択すると、次に示す動的オプションが表示されます。

動的オプション

[SourceType] = [直接入力]

ソース
DDL ステートメントを入力するか、参照ボタン ( [...] ) をクリックしてから [DDL ステートメント] ダイアログボックスでステートメントを入力します。

[SourceType] = [ファイル接続]

ソース
一覧でファイル接続を選択するか、<[新しい接続...]> をクリックし、[ファイル接続マネージャー] ダイアログボックスを使用して新しい接続を作成します。

関連トピック:[ファイル接続マネージャーエディター]

[SourceType] = [変数]

ソース
一覧で変数を選択するか、<[新しい変数...]> をクリックし、[変数の追加] ダイアログボックスを使用して新しい接続を作成します。

関連トピック: Integration Services (SSIS) の変数

次の方法で共有

Analysis Services DDL 実行タスク

DDL ステートメント

DDL の例

Analysis Services DDL 実行タスクの構成

プログラムによる Analysis Services DDL 実行タスクの構成

[Analysis Services DDL 実行タスクエディター] ([全般] ページ)

Options

[Analysis Services DDL 実行タスクエディター] ([DDL] ページ)

静的オプション

動的オプション

[SourceType] = [直接入力]

[SourceType] = [ファイル接続]

[SourceType] = [変数]

フィードバック

フィードバック

その他のリソース

次の方法で共有

Analysis Services DDL 実行タスク

DDL ステートメント

DDL の例

Analysis Services DDL 実行タスクの構成

プログラムによる Analysis Services DDL 実行タスクの構成

[Analysis Services DDL 実行タスク エディター] ([全般] ページ)

Options

[Analysis Services DDL 実行タスク エディター] ([DDL] ページ)

静的オプション

動的オプション

[SourceType] = [直接入力]

[SourceType] = [ファイル接続]

[SourceType] = [変数]

フィードバック

フィードバック

その他のリソース

[Analysis Services DDL 実行タスクエディター] ([全般] ページ)

[Analysis Services DDL 実行タスクエディター] ([DDL] ページ)