多次元データベースラッパー

多次元データベースのラッパーは多次元 DB データソース経由で多次元データベースに接続し、クエリを実行して、結果を返します。

多次元データソース 」で説明されているように、Administration Tool は「多次元 DB」ソースを一覧表示するだけですが、Virtual DataPort は 4 つのタイプの多次元データソースを提供しています。

  • SAPBWBAPI: SAP JCo コネクターを使用した SAP BI と SAP BW へのアクセス用。

  • ESSBASE: Oracle Essbase データベースへのアクセス用。

  • OLAP: XMLA インターフェイスを提供する多次元データベースへのアクセス用。例として、Mondrian と Microsoft SQL Analysis Services があります。

多次元ラッパーと同じ機能を備えています。

以下の例は、次の多次元データベースに接続するラッパーを作成および変更するためのコマンドの構文を示しています。

  • SAPBWBAPI

  • ESSBASE

  • OLAP

リレーショナル構造に MDX クエリの結果がどのようにマッピングされるかの詳細については、管理ガイドの付録「 多次元データからリレーショナルモデルへのマッピング 」を参照してください。

CREATE WRAPPER SAPBWBAPI ステートメントの構文
CREATE [ OR REPLACE ] WRAPPER SAPBWBAPI <name:identifier>
    [ FOLDER = <literal> ]
    DATASOURCENAME = <name:identifier>
    {
          MDXSENTENCE = <name:literal>
        | SCHEMANAME = <name:literal> CUBENAME = <name:literal>
        [ DIMENSIONKEYFIELDS = { TRUE | FALSE } ]
        [ LEAFLEVELMEMBERSONLY = { TRUE | FALSE } ]
        [ INCLUDEEMPTYROWS = { TRUE | FALSE } ]
    }
    [ OUTPUTSCHEMA ( <field> [, <field> ]* ) ]
    [ SOURCECONFIGURATION ( [ <source configuration property>
    [, <source configuration property> ]* ] ) ]

<field> ::=
    <name:identifier> [ = <mapping:literal> ] : <type:literal>
    [ ( { OBL | OPT } ) ]
    [ ( DEFAULTVALUE = <literal> ) ]
    [ EXTERN ]
    [
          <inline constraints> ]*
        | <name:identifier> [ = <mapping:literal> ] : ARRAY OF ( <register
          field> )
    [ ( DEFAULTVALUE = <literal> ) ]
    [
      <inline constraints> ]*
    | <name:register field>

<register field> ::=
    <name:identifier> [ = <mapping:literal> ] :
    REGISTER OF ( <field> [, <field> ]* )
    [ ( DEFAULTVALUE = <literal> ) ]
    [ <inline constraints> ]*

<inline constraint> ::=
      [ NOT ] NULL
    | [ NOT ] UPDATEABLE
    | { SORTABLE [ ASC | DESC ] | NOT SORTABLE }
    | ATTRIBUTE
    | DIMENSIONNAME = <literal>
    | HIERARCHYNAME = <literal>
    | LEVELPOSITION = <position:integer>
    | MEASURE
    | VARIABLE

<source configuration property> ::=
DATAINORDERFIELDSLIST = {
      DEFAULT
    | ( <name:identifier> { ASC | DESC }
        [, <name:identifier> { ASC | DESC } ]* ) }

LEAFLEVELMEMBERSONLY = TRUE 句を追加するのは、Administration Tool の [Multidimensional Data Source] ダイアログで [Include leaf levels of hierarchies only] チェックボックスをチェックするのと同じことです。

INCLUDEEMPTYROWS = TRUE 句を追加するのは、Administration Tool の [Multidimensional Data Source] ダイアログで [Include empty rows] チェックボックスをチェックするのと同じことです。

DIMENSIONKEYFIELDS = TRUE 句を追加するのは、Administration Tool の [Multidimensional Data Source] ダイアログで [Include Member Keys] チェックボックスをチェックするのと同じことです。

これらのオプションの詳細については、管理ガイドの「 多次元データソースから基本ビューをグラフィカルに作成する方法 」を参照してください。

ALTER WRAPPER SAPBWBAPI ステートメントの構文
ALTER WRAPPER SAPBWBAPI <name:identifier>
    [ DATASOURCENAME = <name:identifier> ]
    [
          MDXSENTENCE = <name:literal>
        | SCHEMANAME = <name:literal> CUBENAME = <name:literal>
          [ DIMENSIONKEYFIELDS = { TRUE | FALSE } ]
          [ LEAFLEVELMEMBERSONLY = { TRUE | FALSE } ]
          [ INCLUDEEMPTYROWS = { TRUE | FALSE } ]
    ]
    [ OUTPUTSCHEMA ( <field> [, <field> ]* ) ]
    [ SOURCECONFIGURATION ( [ <source configuration property>
    [, <source configuration property> ]* ] ) ]

<field> ::= (「 CREATE WRAPPER SAPBWBAPI ステートメントの構文 」を参照)

<source configuration property> ::= (「 CREATE WRAPPER SAPBWBAPI ステートメントの構文 」を参照)

CREATE WRAPPER ESSBASE ステートメントの構文
CREATE [ OR REPLACE ] WRAPPER ESSBASE <name:identifier>
    [ FOLDER = <literal> ]
    DATASOURCENAME = <name:identifier>
    SERVERNAME = <name:literal> [ NONAPSSERVERNAME ]
    APPLICATIONNAME = <name:literal>
    CUBENAME = <name:literal>
    [   MDXSENTENCE = <name:literal>
      | INCLUDEEMPTYROWS = { TRUE | FALSE }
        DIMENSIONALIASFIELDS = { TRUE | FALSE }
        DIMENSIONCOMMENTSFIELDS = { TRUE | FALSE } ]     OUTPUTSCHEMA ( <field> [, <field> ]* )
    [ SOURCECONFIGURATION ( [ <source configuration property>
                              [, <source configuration property> ]* ] ) ]
<field> ::=
      <name:identifier> [ = <mapping:literal> ] : <type:literal>
          [ ( { OBL | OPT } ) ]
          [ ( DEFAULTVALUE = <literal> ) ]
          [ EXTERN ]
          [ <inline constraints> ]*
    | <name:identifier> [ = <mapping:literal> ] : ARRAY OF ( <register field> )
          [ ( DEFAULTVALUE = <literal> ) ]
          [ <inline constraints> ]*
    | <name:register field>

<register field> ::=
    <name:identifier> [ = <mapping:literal> ] :
       REGISTER OF ( <field> [, <field> ]* )
       [ ( DEFAULTVALUE = <literal> ) ]
       [ <inline constraints> ]*

<inline constraint> ::=
      [ NOT ] NULL
    | [ NOT ] UPDATEABLE
    | { SORTABLE [ ASC | DESC ] | NOT SORTABLE }
    | ATTRIBUTE
    | HIERARCHYNAME = <literal>
    | LEVELPOSITION = <position:integer>
    | LEVELTYPE = <literal>
    | MEASURE
    | NOAGGREGATE
    | VARIABLE

<source configuration property> ::=
      DATAINORDERFIELDSLIST = { DEFAULT | ( <name:identifier> { ASC | DESC }
                                      [, <name:identifier> { ASC | DESC } ]* ) }

DIMENSIONALIASFIELDS パラメーターが TRUE の場合は、ラッパーと基本ビューが、選択した階層ごとに階層の別名を表すフィールドを含んでいることを示しています。このパラメーターを追加するのは、Administration Tool の Essbase 基本ビューを作成するためのウィザードで [Include member alias] チェックボックスをチェックするのと同じことです。

DIMENSIONCOMMENTSFIELDS パラメーターが FALSE の場合は、ラッパーと基本ビューが、選択した階層ごとに階層のコメントを表すフィールドを含んでいることを示しています。このパラメーターを追加するのは、Administration Tool の Essbase 基本ビューを作成するためのウィザードで [Include member comments] チェックボックスをチェックするのと同じことです。

ALTER WRAPPER ESSBASE ステートメントの構文
ALTER WRAPPER ESSBASE <name:identifier>
    [ FOLDER = <literal> ]
    [ DATASOURCENAME = <name:identifier> ]
    [ SERVERNAME = <name:literal> [ NONAPSSERVERNAME ] ]
    [ APPLICATIONNAME = <name:literal> ]
    [ CUBENAME = <name:literal> ]
    [
          MDXSENTENCE = <name:literal>
        | INCLUDEEMPTYROWS = { TRUE | FALSE }
          DIMENSIONALIASFIELDS = { TRUE | FALSE }
          DIMENSIONCOMMENTSFIELDS = { TRUE | FALSE }
    ]
    [ OUTPUTSCHEMA ( <field> [, <field> ]* ) ]
    [ SOURCECONFIGURATION ( [ <source configuration property>
    [, <source configuration property> ]* ] ) ]

<field> ::= (「 CREATE WRAPPER ESSBASE ステートメントの構文 」を参照)

<source configuration property> ::= (「 CREATE WRAPPER ESSBASE ステートメントの構文 」を参照)

CREATE WRAPPER OLAP ステートメントの構文
CREATE [ OR REPLACE ] WRAPPER OLAP <name:identifier>
    [ FOLDER = <literal> ]
    DATASOURCENAME = <name:identifier>
    {   MDXSENTENCE = <name:literal>
      | CATALOGNAME = <name:literal>
        SCHEMANAME = <name:literal>
        CUBENAME = <name:literal>
    }
    [ OUTPUTSCHEMA ( <field> [, <field> ]* ) ]
    [ SOURCECONFIGURATION ( [ <source configuration property>
                              [, <source configuration property> ]* ] ) ]

<field> ::=
       <name:identifier> = <mapping:literal> [ VALUE <literal> ]
          [ ( { OBL | OPT } ) ]
          [ ( DEFAULTVALUE <literal> ) ]
          [ EXTERN ]
          [ <inline constraints> ]*
     | <name:identifier> = <mapping:literal> : ARRAY OF ( <register field> )
          [ ( DEFAULTVALUE <literal> ) ]
          [ <inline constraints> ]*
     | <name:register field>
          [ ( DEFAULTVALUE <literal> ) ]
          [ <inline constraints> ]*

<register field> ::=
    <name:identifier> = <mapping:literal> :
       REGISTER OF ( [ <field> [, <field> ]* ] )
          [ ( DEFAULTVALUE <literal> ) ]
          [ <inline constraints> ]*

<inline constraint> ::=
     [ NOT ] NULL
   | [ NOT ] UPDATEABLE
   | { SORTABLE [ ASC | DESC ] | NOT SORTABLE }

<source configuration property> ::=
      DATAINORDERFIELDSLIST = { DEFAULT | ( <name:identifier> { ASC | DESC }
                                      [, <name:identifier> { ASC | DESC } ]* ) }
ALTER WRAPPER OLAP ステートメントの構文
ALTER WRAPPER OLAP <name:identifier>
    [ DATASOURCENAME = <name:identifier> ]
    {
          MDXSENTENCE = <name:literal>
        | CATALOGNAME = <name:literal>
          SCHEMANAME = <name:literal>
          CUBENAME = <name:literal>
    }
    [ OUTPUTSCHEMA ( <field> [, <field>]* ) ]
    [ SOURCECONFIGURATION ( [ <source configuration property>
    [, <source configuration property> ]* ] ) ]

<field> ::= (「 CREATE WRAPPER OLAP ステートメントの構文 」を参照)

<source configuration property> ::= (「 CREATE WRAPPER OLAP ステートメントの構文 」を参照)