多次元データベースラッパー¶
多次元データベースのラッパーは多次元 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 [ 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 } ) ]
[ ( <field property> = <literal>
[, <field property> = <literal> ]* ) ]
[ EXTERN ]
[
<inline constraints> ]*
| <name:identifier> [ = <mapping:literal> ] : ARRAY OF ( <register
field> )
[ ( DEFAULTVALUE = <literal> ) ]
[
<inline constraints> ]*
| <name:register field>
<field property> ::=
DEFAULTVALUE
| SOURCETYPESIZE
| SOURCETYPEID
| SOURCETYPENAME
<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
| VAR_TYPE = <literal>
| REF_DIM = <literal>
| REF_HRY = <literal>
<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 <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 [ OR REPLACE ] WRAPPER ESSBASE <name:identifier>
[ FOLDER = <literal> ]
DATASOURCENAME = <name:identifier>
SERVERNAME = <name:literal> [ NONAPSSERVERNAME ]
APPLICATIONNAME = <name:literal>
CUBENAME = <name:literal>
[ XMLAMODE = { TRUE | FALSE } ]
[ 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] チェックボックスをチェックするのと同じことです。
パラメータ XMLAMODE
が TRUE
の場合、Essbase のクエリがレベルと生成の XMLA 業界標準定義に従って結果を生成します。このパラメータを追加するのは、Administration Tool の [MDX Query] から Essbase 基本ビューを作成するためのウィザードの [XMLA Mode] セクションで値 [Standard] を選択するのと同じことです。
ALTER WRAPPER ESSBASE <name:identifier>
[ FOLDER = <literal> ]
[ DATASOURCENAME = <name:identifier> ]
[ SERVERNAME = <name:literal> [ NONAPSSERVERNAME ] ]
[ APPLICATIONNAME = <name:literal> ]
[ CUBENAME = <name:literal> ]
[ XMLAMODE = { TRUE | FALSE } ]
[
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 [ 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 <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 ステートメントの構文 」を参照)