接続の設定
コネクタのインストール 後、Azure Data Lake Storage 内のデータのデータソースに接続して作成できます。
データソースの設定
データに接続するには、次の手順を実行してください：
- 接続 | To a Server で詳細をクリックします。
- Azure Data Lake Storage by CData というデータソースを選択します。
- 接続に必要な情報を入力します。
- サインインをクリックします。
- 必要に応じて、データベースおよびスキーマを選択して利用可能なテーブルとビューを確認できます。
Connection Builder の使用
connector は、代表的な接続プロパティをTableau 内で直接利用できるようにします。 しかし、より高度な設定が必要な場合や接続に関するトラブルシューティングが必要な場合には、使いにくいことがあります。 connector には、Tableau の外で接続を作成してテストできる、独立したConnection Builder が付属しています。
Connection Builder にアクセスする方法は2つあります。
- Windows では、スタートメニューのCData Tableau Connector for Azure Data Lake Storage フォルダの下にあるConnection Builder というショートカットを使用します。
- また、ドライバーのインストールディレクトリに移動し、lib ディレクトリで.jar ファイルを実行することによってもConnection Builder を開始できます。
Connection Builder では、接続プロパティに値を設定し、接続テストをクリックしてその動作を確認できます。 また、クリップボードにコピーボタンを使用して、接続文字列をコピーすることもできます。 この接続文字列は、Tableau 内のconnector 接続ウィンドウにあるConnection String オプションに指定できます。
Azure DataLakeStorage Gen 1 への接続
To connect to a Gen 1 DataLakeStorage account, you should first set the following properties:
- Schema：ADLSGen1 に設定。
- Account：アカウント名に設定。
- AzureTenant：テナントId に設定。取得方法について詳しくは、プロパティを参照してください。
- Directory：（オプション）複製されたファイルを格納するために使用されるパスに設定。指定しない場合は、ルートディレクトリが使用されます。
Azure DataLakeStorage Gen 1 への認証
Gen 1 は、次の認証メソッドをサポートしています。Azure Active Directory OAuth (AzureAD) and Managed Service Identity (AzureMSI).
Azure AD
Azure AD は、Microsoft のマルチテナント、クラウドベースのディレクトリおよびID 管理サービスです。これはユーザーベースの認証で、AuthScheme をAzureAD に設定する必要があります。Web アプリケーションを介したAzure AD への認証には、必ずカスタムOAuth アプリケーションの作成が必要です。詳細はAzure AD アプリケーションの作成 を参照してください。
デスクトップアプリケーション
CData は、デスクトップアプリケーションからAzure AD への接続を簡略化する埋め込みOAuth アプリケーションを提供します。カスタムOAuth アプリケーションを使用して、デスクトップアプリケーションで認証することもできます。（詳しくは、Azure AD アプリケーションの作成 を参照してください。） Azure AD 経由で認証するには、以下のパラメータを設定します。
- AuthScheme：AzureAD。
-
カスタムアプリケーションのみ：
- OAuthClientId：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントId。
- OAuthClientSecret：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット。
- CallbackURL：カスタムOAuth アプリケーションの登録時に定義したリダイレクトURI。
接続すると、connector はデフォルトブラウザでAzure Data Lake Storage のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。
connector はOAuth プロセスを完了し、Azure Data Lake Storage からアクセストークンを取得してそれを使ってデータをリクエストします。 OAuth 値はOAuthSettingsLocation で指定されたパスに保存されます。これらの値は接続間で永続化されます。
アクセストークンの期限が切れたときは、connector は自動でアクセストークンをリフレッシュします。
Managed Service Identity (MSI)
Azure VM 上でAzure Data Lake Storage を実行しており、MSI を利用して接続したい場合は、AuthScheme をAzureMSI に設定します。
User-Managed Identities
マネージドID のトークンを取得するには、OAuthClientId プロパティを使用してマネージドID の"client_id" を指定します。VM に複数のユーザーが割り当てられたマネージドID がある場合は、OAuthClientId も指定する必要があります。
Azure DataLakeStorage Gen 2 への接続
To connect to a Gen 2 DataLakeStorage account, you should first set the following properties:
- Schema：ADLSGen2 に設定。
- Account：ストレージアカウント名に設定。
- FileSystem：このアカウントに使用されるファイルシステム名に設定。例えば、Azure Blob コンテナの名前。
- Directory：（オプション）複製されたファイルを格納するために使用されるパスに設定。指定しない場合は、ルートディレクトリが使用されます。
Azure DataLakeStorage Gen 2 への認証
Gen 2 supports the following authentication methods: using an AccessKey, using a Shared Access Signature, Azure Active Directory OAuth (AzureAD), Managed Service Identity (AzureMSI).
Access Key を使用した認証
To connect using a Shared Access Signature set the AccessKey property and the AuthScheme to AccessKey.
You can obtain an access key for the ADLS Gen2 storage account using the Azure portal:
- Go to your ADLS Gen2 Storage Account in the Azure portal.
- 設定で［アクセスキー］を選択します。
- Copy the value for one of the available access keys to the AccessKey connection property.
共有アクセス署名（SAS）
To connect using a Shared Access Signature set the SharedAccessSignature property to a valid signature of a resource to connect to and the AuthScheme to SAS. The SharedAccessSignature may be generated with a tool such as Azure Storage Explorer.
Azure AD
Azure AD は、Microsoft のマルチテナント、クラウドベースのディレクトリおよびID 管理サービスです。これはユーザーベースの認証で、AuthScheme をAzureAD に設定する必要があります。Web アプリケーションを介したAzure AD への認証には、必ずカスタムOAuth アプリケーションの作成が必要です。詳細はAzure AD アプリケーションの作成 を参照してください。
デスクトップアプリケーション
CData は、デスクトップアプリケーションからAzure AD への接続を簡略化する埋め込みOAuth アプリケーションを提供します。カスタムOAuth アプリケーションを使用して、デスクトップアプリケーションで認証することもできます。（詳しくは、Azure AD アプリケーションの作成 を参照してください。） Azure AD 経由で認証するには、以下のパラメータを設定します。
- AuthScheme：AzureAD。
-
カスタムアプリケーションのみ：
- OAuthClientId：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントId。
- OAuthClientSecret：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット。
- CallbackURL：カスタムOAuth アプリケーションの登録時に定義したリダイレクトURI。
接続すると、connector はデフォルトブラウザでAzure Data Lake Storage のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。
connector はOAuth プロセスを完了し、Azure Data Lake Storage からアクセストークンを取得してそれを使ってデータをリクエストします。 OAuth 値はOAuthSettingsLocation で指定されたパスに保存されます。これらの値は接続間で永続化されます。
アクセストークンの期限が切れたときは、connector は自動でアクセストークンをリフレッシュします。
Managed Service Identity (MSI)
Azure VM 上でAzure Data Lake Storage を実行しており、MSI を利用して接続したい場合は、AuthScheme をAzureMSI に設定します。
User-Managed Identities
マネージドID のトークンを取得するには、OAuthClientId プロパティを使用してマネージドID の"client_id" を指定します。VM に複数のユーザーが割り当てられたマネージドID がある場合は、OAuthClientId も指定する必要があります。
次のステップ
データビジュアライゼーションを作成するには、コネクタの使用 を参照してください。