次の方法で共有

Analysis Services DDL 実行タスク

  • [アーティクル]

適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム

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>

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

Analysis Services DDL 実行タスクの構成

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

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

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

プログラムによる 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] = [直接入力]

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

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

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

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

[SourceType] = [変数]

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

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