# Microsoft Azure Analysis Services (SSAS) - インポート

Availability-note[AWS](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-aws)

AWS 専用機能は us.cloud.talend.com、eu.cloud.talend.com、ap.cloud.talend.com で利用できます。

## ブリッジの要件

このブリッジ:

* ドライバーを<TDC\_HOME>/data/download/MIMB/にダウンロードするためには、https://repo.maven.apache.org/maven2/ やその他のツールサイトへのインターネットアクセスが必要です。

* Microsoft Windowsではサポートされていません。

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

## ブリッジの仕様

| **ベンダー** | **Microsoft** |
| --- | --- |
| **ツール名** | **Azure Analysis Services (SSAS)** |
| **ツールバージョン** | **9.0 (2005)〜16.x (2022)** |
| **ツールの Web サイト** | https://azure.microsoft.com/en-us/services/analysis-services/ (英語のみ) |
| **サポートされている方法論** | [ビジネスインテリジェンス] メタデータリポジトリー、データストア(物理データモデル、OLAPディメンショナルモデル、ストアドプロシージャー式解析)、.Net API経由のBIデザイン(RDBMSソース、OLAPソース、ディメンショナルターゲット、変換来歴、式解析) |
| **データプロファイリング** | ![](https://help.qlik.com/talend/ja-JP/talend-data-catalog/8.1/Content/Resources/images/cross.png) |
| **増分収集** | ![](https://help.qlik.com/talend/ja-JP/talend-data-catalog/8.1/Content/Resources/images/cross.png) |
| **マルチモデル収集** | ![](https://help.qlik.com/talend/ja-JP/talend-data-catalog/8.1/Content/Resources/images/cross.png) |
| **モデル選択のためのリモート リポジトリーの参照** | ![](https://help.qlik.com/talend/ja-JP/talend-data-catalog/8.1/Content/Resources/images/tick.png) |

**仕様**  
**ツール:** .Net経由のMicrosoft / Azure Analysis Services (SSAS)バージョン9.0 (2005)～16.x (2022)  
https://azure.microsoft.com/en-us/services/analysis-services/をご覧ください。  
**メタデータ:** [ビジネスインテリジェンス] メタデータリポジトリー、データストア(物理データモデル、OLAPディメンショナルモデル、ストアドプロシージャー式解析)、 BIデザイン(RDBMSソース、OLAPソース、ディメンショナルターゲット、変換来歴、式解析)  
**コンポーネント:** MicrosoftSqlServerRepositoryAsImport.MicrosoftAzureAnalysisServicesバージョン11.2.0  
  
**免責事項**  
このインポートブリッジでは、インターネットに接続して次のサードパーティライブラリーをダウンロードする必要があります。  
- オープンソースのサードパーティライブラリーのダウンロードはhttps://repo.maven.apache.org/maven2/などへ  
- その他のサードパーティソフトウェア(データベース特定のJDBCドライバーなど)は該当するサイトへ  
  
ダウンロードされたサードパーティライブラリーは、$HOME/data/download/MIMB/ に格納されています。  
HTTPS が失敗した場合、インポートブリッジは HTTP を試します。  
- インターネットへのアクセスにプロキシを使用している場合は、JREでそのプロキシを設定する必要があります(Miscellaneousパラメーターで -java.parametersオプションをご覧ください)。  
- インポートブリッジではインターネットにフルにアクセスできない場合は、インターネットアクセスがある別のサーバーから$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 |  |  | 必須 |
| **データベース** | インポートするSQL Server Analysis Servicesのプロジェクト名(例: /Adventure Works DW Standard Edition)。<br>Azureの場合はモデル名(例: /TabularProject)を付けます。 | REPOSITORY\_MODEL |  |  | 必須 |
| **ユーザー** | ユーザーの値は、認証方法に応じて、ユーザ名、クライアントID、その他(空でも可)となります。<br>このブリッジのメインドキュメンテーションで、認証に関するセクションをご覧ください。 | STRING |  |  |  |
| **シークレット** | シークレットの値は、認証方法に応じて、パスワード、シークレットID、その他(空でも可)となります。<br>このブリッジのメインドキュメンテーションで、認証に関するセクションをご覧ください。 | パスワード |  |  |  |
| **Miscellaneous** | **モデルインポートのオプション**<br>**-backup &lt;directory&gt;**<br>さらなるトラブルシューティングのためにメタデータ入力ファイルを保存する空ディレクトリーのフルパス。<br><br>**データ接続オプション**<br>使用するソースとターゲットのデータストアを参照するよう、通常はETL/DIツールとBIツールのインポートブリッジによってデータ接続が生成されます。これらのデータ接続はメタデータ管理ツールによって実際のデータストア(データベースやファイルシステムなど)への接続(メタデータスティッチング)に使われ、完全なエンドツーエンドのデータフローの来歴とインパクト分析が行われます。各データ接続の名前はインポートモデルごとに一意です。DI/BIデザインツールで使われているデータ接続名を可能な限り使用します。そうでない場合は、データベース/スキーマ名、ファイルシステムのパス、Uniform Resource Identifier (URI)など、短くても意味のある接続名が生成されます。次のオプションを使えば、接続を操作できます。これらのオプションによって、レガシーオプションである-c、-cd、-csが置き換えられます。<br><br>**-connection.cast ConnectionName=ConnectionType**<br><br>-connection.cast "My Database"="SQL SERVER"のように、SQL解析のためにジェネリックデータベース接続(ODBCやJDBCなど)を正確なデータベースタイプ(ORACLEなど)にキャストします。<br>サポートされているデータストア接続タイプのリストには、以下が含まれています:<br>ACCESS<br>CASSANDRA<br>DB2<br>DENODO<br>HIVE<br>MYSQL<br>NETEZZA<br>ORACLE<br>POSTGRESQL<br>PRESTO<br>REDSHIFT<br>SALESFORCE<br>SAP HANA<br>SNOWFLAKE<br>SQL SERVER<br>SYBASE<br>TERADATA<br>VECTORWISE<br>VERTICA<br><br>**-connection.rename OldConnection=NewConnection**<br>既存の接続を新しい名前に変更します。例:<br>-connection.rename OldConnectionName=NewConnectionName<br>既存の複数のデータベース接続の名前を変更し、新しい1つのデータベース接続に統合できます。例:<br>-connection.rename MySchema1=MyDatabase -connection.rename MySchema2=MyDatabase<br><br>**-connection.split OldConnection.Schema1=NewConnection**<br>データベース接続を1つまたは複数のデータベース接続に分割します。<br>1つのデータベース接続をスキーマごとの1つの接続に分割できます。例:<br>-connection.split MyDatabase<br>すべてのデータベース接続をスキーマごとの1つの接続に分割できます。例:<br>-connection.split \*<br>データベースにスキーマ名を追加することで、データベース接続を明示的に分割し、新しいデータベース接続を作成できます。例:<br>-connection.split MyDatabase.schema1=MySchema1<br><br>**-connection.casesensitive ConnectionName**<br>検出されたデータストアのタイプがこの設定(Microsoft SQL ServerやMySqlなど)をサポートしている場合は、指定された接続内のオブジェクト識別子に対し、大文字と小文字を区別しないデフォルトのマッチングルールがオーバーライドされます。例:<br>-connection.casesensitive "My Database"<br><br>**ANALYSIS SERVERのオプション**<br>**-library.packageId**<br>Microsoft.AnalysisServices.dllを使ってNuGetパッケージのpackageIdを指定します。<br>デフォルト値はMicrosoft.AnalysisServices.retail.amd64です。<br><br>**-library.version**<br>Microsoft.AnalysisServices.dllを使ってNuGetパッケージのバージョンを指定します。<br>デフォルト値は19.20.1です。<br><br>**-library.filter**<br>NuGetパッケージ内のDLLのフィルターを指定します。結果にはMicrosoft.AnalysisServices.dllが含まれている必要があります。<br>デフォルト値は/lib/net45/です。<br><br>**-connection.embedded**<br>組み込みデータソースに対する処理を可能にします。<br>組み込みデータソースはレポート固有のデータソースとも呼ばれ、レポート定義に保存されるデータ接続です。組み込み済みのデータソース接続情報は、それが組み込まれているレポートでのみ使用できます。<br><br>**-d**<br>NuGetパッケージがない場合はダウンロードするよう指定します。初回ダウンロード時にキャッシュし、その後で再利用します。<br><br>**-cache.clear**<br>インポート前にキャッシュをクリアするため、増分収集せずにフルインポートを実行します。 | STRING |  |  |  |

## ブリッジのマッピング

| **Meta Integration Repository (MIR)<br>メタモデル<br>(OMG CWM標準に基づく)** | **"Microsoft Azure Analysis Services (SSAS)"<br>メタモデル<br>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 | 名前 |  |