メイン コンテンツをスキップする 補完的コンテンツへスキップ

Microsoft SQL Server Analysis Services (SSAS) (DSVファイル経由) - エクスポート

Availability-note AWS

ブリッジの要件

このブリッジ:
  • Microsoft Windowsではサポートされていません。

  • そのSDKにアクセスするためにはツールのインストールが必要です。

ブリッジの仕様

ベンダー Microsoft
ツール名 SQL Server Analysis Services (SSAS)
ツールバージョン 9.0 (2005)〜15.x (2019)
ツールのWebサイト https://docs.microsoft.com/en-us/analysis-services/
サポートされている方法論 [ビジネスインテリジェンス] メタデータリポジトリー、データストア(物理データモデル、OLAPディメンショナルモデル、ストアドプロシージャー式解析)、.Net API経由のBIデザイン(RDBMSソース、OLAPソース、ディメンショナルターゲット、変換来歴、式解析)

仕様
ツール: .Net API
経由のMicrosoft / SQL Server Analysis Services (SSAS)バージョン9.0 (2005)~5.x (2019) https://docs.microsoft.com/en-us/analysis-services/をご覧ください。
メタデータ: [ビジネスインテリジェンス] メタデータリポジトリー、データストア(物理データモデル、OLAPディメンショナルモデル、ストアドプロシージャー式解析)、 BIデザイン(RDBMSソース、OLAPソース、ディメンショナルターゲット、変換来歴、式解析)
コンポーネント: MicrosoftSqlServerRepositoryAsバージョン11.2.0

免責事項
このインポートブリッジでは、インターネットに接続して次のサードパーティライブラリーをダウンロードする必要があります。
- オープンソースのサードパーティライブラリーのダウンロードはhttps://repo.maven.apache.org/maven2/などへ
- その他のサードパーティソフトウェア(データベース特定のJDBCドライバーなど)は該当するサイトへ

ダウンロードされたサードパーティライブラリーは、$HOME/data/download/MIMB/に格納されています。
HTTPSが失敗した場合、インポートブリッジはHTTPを試します。
- インターネットへのアクセスにプロキシを使用している場合は、JREでそのプロキシを設定する必要があります(Miscellaneousパラメーターで -j オプションをご覧ください。)。
- インポートブリッジではインターネットにフルにアクセスできない場合は、インターネットアクセスがある別のサーバーから$HOME/data/download/MIMB/ディレクトリーをコピーします。$HOME/bin/MIMB.sh (または.bat) -dというコマンドを使えば、すべてのブリッジで使用される全サードパーティライブラリーを一度にダウンロードできます。

このインポートブリッジを実行すると、ライセンス規約の責任、およびダウンロードしたサードパーティソフトウェアライブラリーによって生じる潜在的なセキュリティの脆弱性を受け入れることになります。

概要
このブリッジは、分析データベース(OLAPモデル)および分析管理オブジェクト(AMO)を含め、ビジネスインテリジェンス(BI)レポートメタデータをMicrosoft SQL Server Analysis Services (SSAS)からインポートします。
ブリッジはAnalysis Services Tabularモデル、多次元モデル、Azure Tabularモデルをサポートします。

要件
このブリッジは、Analysis Services Management Objects (AMO)を使ってSQL Serverリポジトリーに接続します。AMOクライアントライブラリーはNuGet.orgからインストール可能なパッケージとして提供されており、ブリッジはMiscellaneous -dでこのライブラリーを自動的にロードします。これらのコンポーネントは初回実行時にインストールする必要があります。

このブリッジは、 Windows Authentication to connect to Analysis Services by default. [ユーザー]オプションが空の場合は、インポートしたいオブジェクトに対して適切な権限を持つユーザーとしてアプリケーションがWindowsドメインにログインしていることをご確認ください。

認証
ユーザーロールには、SSASデータベースに対して少なくとも[定義を読み取り]権限が必要です
ユーザーとシークレットのパラメーター値に基づいて、次のいずれかの認証方式を使います:

- Microsoft SQL Serverアプリケーションの認証情報:
ユーザー = アプリケーションユーザー
シークレット = アプリケーションパスワード

- Microsoft Azure Key Vaultシークレット:
ユーザー = ターゲットサーバーに[Analysis Servicesサーバー管理者]として追加されるアプリケーションユーザー(例: user@gmail.com)。
シークレット = Secret@VaultURL
詳細は、https://docs.microsoft.com/en-us/azure/key-vault/をご覧ください。

- Microsoft Azureのシークレットの認証情報:
ユーザー = ClientID@TenantID
シークレット = ClientSecret
詳細は、https://docs.microsoft.com/en-us/azure/key-vault/secrets/をご覧ください。

- Microsoft Azureの一時認証情報(外部メタデータによって管理されているクラウドアイデンティティ):
ユーザー = ""
シークレット = ""
これは、シークレットパラメーターが空の場合にデフォルトで最初に試行される認証方法です。
詳細は、メタデータ収集のためのクラウドID管理に関するメタデータ管理(MM) / データカタログ / データガバナンスアプリケーションのドキュメンテーションをご覧ください。

- Microsoft Azure Managed Service Identity (MSI):
ユーザー = ""
シークレット = ""
これは、上記の両パラメーターが空の場合にデフォルトで2番目に試行される認証方法です。ただし、この認証方法は次の設定で強制させることもできます:
その他 = -auth.msi
詳細は、https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resourcesをご覧ください。

- Microsoft Windows Integrated Security:
ユーザー = ""
シークレット = ""
これは、上記の両パラメーターが空の場合にデフォルトで3番目に試行される認証方法です。ただし、この認証方法は次の設定で強制させることもできます:
その他 = -auth.integrated

よくある質問
該当なし

制限事項
現在判明している一般的な制限事項は、https://metaintegration.com/Products/MIMB/Help/#!Documents/mimbknownlimitations.htmlをご覧ください。

サポート
トラブルシューティングパッケージを次の項目と共に提供してください。
- デバッグログ(UIまたはconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定可能)
- メタデータのバックアップ(Miscellaneousパラメーターで-backupオプションによって設定可能)

ソースメタデータの完全なセットを提供してSSASの問題を再現するには、エクスポートされた分析データベース(XMLA)ファイルを入力します。


ブリッジパラメーター

パラメーター名 説明 タイプ デフォルト スコープ
分析サーバーのインスタンス 接続する分析サーバーのインスタンス(例: hostnameまたはhostname\\instance)。レポートがAnalysis Serverデータベースから取得されない場合は、空のままにしておきます。 STRING     必須
[Database] (データベース) インポートするSQL Server Analysis Servicesのプロジェクト名(例: /Adventure Works DW Standard Edition)。
Azureの場合はモデル名(例: /TabularProject)を付けます。
REPOSITORY_MODEL     必須
ユーザー ユーザーの値は、認証方法に応じて、ユーザ名、クライアントID、その他(空でも可)となります。
このブリッジのメインドキュメンテーションで、認証に関するセクションをご覧ください。
STRING      
シークレット シークレットの値は、認証方法に応じて、パスワード、シークレットID、その他(空でも可)となります。
このブリッジのメインドキュメンテーションで、認証に関するセクションをご覧ください。
パスワード      
Miscellaneous モデルインポートのオプション
-backup <directory>

さらなるトラブルシューティングのためにメタデータ入力ファイルを保存する空ディレクトリーのフルパス。

データ接続オプション
使用するソースとターゲットのデータストアを参照するよう、通常はETL/DIツールとBIツールのインポートブリッジによってデータ接続が生成されます。これらのデータ接続はメタデータ管理ツールによって実際のデータストア(データベースやファイルシステムなど)への接続(メタデータスティッチング)に使われ、完全なエンドツーエンドのデータフローの来歴とインパクト分析が行われます。各データ接続の名前はインポートモデルごとに一意です。DI/BIデザインツールで使われているデータ接続名を可能な限り使用します。そうでない場合は、データベース/スキーマ名、ファイルシステムのパス、Uniform Resource Identifier (URI)など、短くても意味のある接続名が生成されます。次のオプションを使えば、接続を操作できます。これらのオプションによって、レガシーオプションである-c、-cd、-csが置き換えられます。

-connection.cast ConnectionName=ConnectionType


-connection.cast "My Database"="SQL SERVER"のように、SQL解析のためにジェネリックデータベース接続(ODBCやJDBCなど)を正確なデータベースタイプ(ORACLEなど)にキャストします。
サポートされているデータストア接続タイプのリストには、以下が含まれています:
ACCESS
CASSANDRA
DB2
DENODO
HIVE
MYSQL
NETEZZA
ORACLE
POSTGRESQL
PRESTO
REDSHIFT
SALESFORCE
SAP HANA
SNOWFLAKE
SQL SERVER
SYBASE
TERADATA
VECTORWISE
VERTICA

-connection.rename OldConnection=NewConnection

既存の接続を新しい名前に変更します。例:
-connection.rename OldConnectionName=NewConnectionName
既存の複数のデータベース接続の名前を変更し、新しい1つのデータベース接続に統合できます。例:
-connection.rename MySchema1=MyDatabase -connection.rename MySchema2=MyDatabase

-connection.split OldConnection.Schema1=NewConnection

データベース接続を1つまたは複数のデータベース接続に分割します。
1つのデータベース接続をスキーマごとの1つの接続に分割できます。例:
-connection.split MyDatabase
すべてのデータベース接続をスキーマごとの1つの接続に分割できます。例:
-connection.split *
データベースにスキーマ名を追加することで、データベース接続を明示的に分割し、新しいデータベース接続を作成できます。例:
-connection.split MyDatabase.schema1=MySchema1

-connection.casesensitive ConnectionName

検出されたデータストアのタイプがこの設定(Microsoft SQL ServerやMySqlなど)をサポートしている場合は、指定された接続内のオブジェクト識別子に対し、大文字と小文字を区別しないデフォルトのマッチングルールがオーバーライドされます。例:
-connection.casesensitive "My Database"

ANALYSIS SERVERのオプション
-library.packageId

Microsoft.AnalysisServices.dllを使ってNuGetパッケージのpackageIdを指定します。
デフォルト値はMicrosoft.AnalysisServices.retail.amd64です。

-library.バージョン

Microsoft.AnalysisServices.dllを使ってNuGetパッケージのバージョンを指定します。
デフォルト値は19.20.1です。

-library.filter

NuGetパッケージ内のDLLのフィルターを指定します。結果にはMicrosoft.AnalysisServices.dllが含まれている必要があります。
デフォルト値は/lib/net45/です。

-connection.embedded

組み込みデータソースに対する処理を可能にします。
組み込みデータソースはレポート固有のデータソースとも呼ばれ、レポート定義に保存されるデータ接続です。組み込み済みのデータソース接続情報は、それが組み込まれているレポートでのみ使用できます。

-d

NuGetパッケージがない場合はダウンロードするよう指定します。初回ダウンロード時にキャッシュし、その後で再利用します。

-cache.clear

インポート前にキャッシュをクリアするため、増分収集せずにフルインポートを実行します。
STRING      

 

ブリッジのマッピング

Meta Integration Repository (MIR)
メタモデル
(OMG CWM標準に基づく)
"Microsoft SQL Server Analysis Services (SSAS) 2005〜2019 (リポジトリー)"
メタモデル
MicrosoftSqlServerXMLA
マッピングのコメント
     
AggregationRule AggregateFunction メジャー内で定義されている文字列
ルール  
キューブ キューブ  
説明 説明  
名前 名前  
NativeId ID  
PhysicalName 名前  
CubeDimensionAssociation   キューブとディメンション間の包含リレーションシップによって定義
ディメンション ディメンション  
説明 説明  
非表示 表示  
名前 名前  
NativeId ID  
NativeType タイプ  
PhysicalName 名前  
DimensionAttribute DimensionAttribute  
説明 説明  
名前 名前  
NativeId ID  
PhysicalName 名前  
階層 階層  
説明 説明  
名前 名前  
NativeId ID  
PhysicalName 名前  
HierarchyLevelAssociation   階層とレベル間の包含リレーションシップによって定義
結合 リレーションシップ DataSourceViewによって定義
説明 説明  
名前 名前  
NativeId ID  
タイプ タイプ  
JoinRole   リレーションシップによって定義
[Level](レベル) [Level](レベル)  
説明 説明  
名前 名前  
NativeId ID  
NativeType タイプ  
PhysicalName 名前  
LevelAssociation   レベルと属性間の包含によって定義
LevelAttribute DimensionAttribute レベルによって包含
説明 説明  
名前 名前  
NativeId ID  
オプション Usage (属性)  
PhysicalName 名前  
LevelKey ValueColumn  
説明 説明  
名前 名前  
NativeId ID  
NativeType タイプ  
PhysicalName 名前  
メジャー メジャー  
DefaultAggregation AggregationString  
説明 説明  
非表示 表示  
名前 名前  
NativeId ID  
NativeType タイプ  
PhysicalName 名前  

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。