接続の設定

コネクタのインストール後、MySQL 内のデータのデータソースに接続して作成できます。

データソースの設定

データに接続するには、次の手順を実行してください：

接続 | To a Server で詳細をクリックします。
MySQL by CData というデータソースを選択します。
接続に必要な情報を入力します。
サインインをクリックします。
必要に応じて、データベースおよびスキーマを選択して利用可能なテーブルとビューを確認できます。

Connection Builder の使用

connector は、代表的な接続プロパティをTableau 内で直接利用できるようにします。しかし、より高度な設定が必要な場合や接続に関するトラブルシューティングが必要な場合には、使いにくいことがあります。 connector には、Tableau の外で接続を作成してテストできる、独立したConnection Builder が付属しています。

Connection Builder にアクセスする方法は2つあります。

Windows では、スタートメニューのCData Tableau Connector for MySQL フォルダの下にあるConnection Builder というショートカットを使用します。
また、ドライバーのインストールディレクトリに移動し、lib ディレクトリで.jar ファイルを実行することによってもConnection Builder を開始できます。

Connection Builder では、接続プロパティに値を設定し、接続テストをクリックしてその動作を確認できます。また、クリップボードにコピーボタンを使用して、接続文字列をコピーすることもできます。この接続文字列は、Tableau 内のconnector 接続ウィンドウにあるConnection String オプションに指定できます。

MySQL への接続

次のプロパティを設定し、MySQL データに接続します。

Server：MySQL データベースをホスティングしているサーバーのホスト名またはIP アドレス。
Port：MySQL データベースをホスティングしているサーバーのポート。
Database（オプション）：MySQL Server に接続する場合のデフォルトデータベース。設定されていない場合、MySQL は使用可能なすべてのデータベースからテーブルを返します。

MySQL への認証

MySQL は次の認証をサポートします。

標準
NT Lan Manager（NTLM）
LDAP
SSL
SSH
Azure
AWS

標準認証

標準認証で認証するには、AuthScheme をPassword に設定し、以下のプロパティを設定します。

User：認証するMySQL ユーザーのユーザー名。
Password：認証するMySQL ユーザーに関連付けられたパスワード。

NTLM

NTLM を使用して認証するには、AuthScheme をNTLM に設定します。

デフォルトでは、connector は、実行中のPC のドメインまたはMySQL インスタンスを実行しているマシンで使用されているドメインのいずれかを使用して、ユーザー資格情報とNTLM ドメインを自動的に決定します。ユーザー資格情報を取得するために、connector は現在のNTLM ユーザーを読み込みます。

異なるドメインを指定したい場合は、異なるログイン資格情報を提供するか、あるいは以下のオプションプロパティのいずれかまたはすべてを用いてターゲットNTLM バージョンを変更します。

User：認証するNTLM ユーザー。
Password：認証するNTLM ユーザーのパスワード。
Domain：接続するドメイン名。
NTLMVersion：connector で使用されるNTLM のバージョン。有効な値は1（デフォルト）および2です。

LDAP

LDAPユーザーとして認証するには、AuthScheme をLDAP に設定します。

LDAP 認証情報はデフォルトで自動検出されます。別のユーザーとアカウントを指定したい場合は、以下のオプションプロパティを設定します。

User：ログインするユーザー。
Password：ユーザーのパスワード。

SSL

SSL 認証を活用してMySQL データに安全に接続するには、以下のプロパティを設定します。

SSLClientCert：クライアント証明書のための証明書ストア名。クライアントとサーバーの両方のマシンでトラストストアとキーストアが保持される2-way SSL の場合に使用されます。
SSLClientCertPassword：クライアント証明書ストアパスワード。証明書ストアがパスワードで保護されている場合は必須です。
SSLClientCertSubject：TLS / SSL クライアント証明書のサブジェクト。ストア内の証明書を検索するために使用されます。
SSLClientCertType:; クライアントストアの証明書タイプ。
SSLServerCert：サーバーが受け入れ可能な証明書。

SSH

SSH 経由でリモートマシンを認証し、MySQL データにアクセスするには、以下のプロパティを設定します。

SSHClientCert：クライアント証明書のための証明書ストア名。
SSHClientCertPassword：クライアント証明書ストアがパスワードで保護されている場合、この値をストアのパスワードに設定。
SSHClientCertSubject：TLS / SSL クライアント証明書のサブジェクト。ストア内の証明書を検索するために使用されます。
SSHClientCertType：クライアントストアの証明書タイプ。
SSHPassword：SSH サーバーに認証するためのパスワード。
SSHPort：SSH 操作に使用されるポート。
SSHServer：認証を試行中のSSH 認証サーバー。
SSHServerFingerPrint：接続を試行中のホストの検証に使用される、SSH サーバ－の指紋。
SSHUser：SSH サーバーへの認証に使用するユーザー名。

Azure 上のMySQL

Azure AD にホストされているMySQL データベースは、Azure AD ユーザー（Azure ユーザークレデンシャルを使用）、Azure MSI（マネージドサービスID を使用）、またはAzure パスワードで認証できます。以下の表に、3つの認証方式すべてに必要な接続パラメータを示します。


	パラメータ	設定値	注記
Azure AD ユーザー	AzureTenant	MySQL が設置されているMicrosoft Online テナント。	注記1 参照。
	AuthScheme	AzureAD	注記2 参照。
Azure MSI	AzureTenant	MySQL が設置されているMicrosoft Online テナント。	注記1 参照。
	AuthScheme	AzureMSI	MySQL がAzure VM 上で実行されている場合に最もよく使用されます。
	OAuthClientId	マネージドID のclient_identity	マネージドID のトークンを取得する場合、またはVM にユーザー割り当てのマネージドID が複数ある場合に必要です。
Azure パスワード	AuthScheme	AzurePassword	Azure 認証情報を使用して直接接続するには、Azure への接続に使用するアカウントのユーザーとパスワードを指定します。

注記

AzureTenant は、一般的にcompanyname.microsoft.com の形式で提供されますが、テナントId を指定することもできます。（テナントId は、Azure ポータルのAzure Active Directory -> プロパティページに表示されるディレクトリId と同じものです。）
OAuthGrantType がCODE（デフォルト）に設定されている場合、ユーザーが複数のテナントに属していない限り、AzureTenant は通常必要ありません。OAuthGrantType がCLIENT に設定されている場合、AzureTenant は必須です。
AzureAD AuthScheme は一般的に、必要なOAuth 資格情報を確立するために、カスタムOAuth アプリケーションと共に使用されます。これらは通常、アカウント識別子またはクライアントID と、アカウントパスワードまたはクライアントシークレットの形をとります。

AWS 上のMySQL

IAM ロールまたはEC2 ロールのいずれかを使用して、AWS でホストされているMySQL データベースに接続できます。

AWS IAM Roles

AuthScheme をAwsIAMRoles に設定します。

多くの場合、認証にはAWS ルートユーザーのダイレクトなセキュリティ認証情報ではなく、IAM ロールを使用することをお勧めします。AWS ルートユーザーのAWSAccessKey およびAWSSecretKey を指定している場合、ロールは使用できない場合があります。

AWS ロールとして認証するには、次のプロパティを設定します。

AWSAccessKey：ロールを担うIAM ユーザーのアクセスキー。
AWSSecretKey：ロールを担うIAM ユーザーのシークレットキー。
AWSRoleARN：認証したいロールのRole ARN を指定。これにより、connector は指定されたロールの資格情報を取得しようと試みます。

多要素認証が必要な場合は、以下を指定します。

CredentialsLocation：MFA クレデンシャルが保存される設定ファイルの場所。詳しくは、接続文字列オプションのCredentials File Location のページを参照してください。
MFASerialNumber：MFA デバイスが使用されている場合は、そのシリアル番号。
MFAToken：MFA デバイスから利用できる一時トークン。

これにより、connector は一時的な認証情報を取得するために、リクエストでMFA 認証情報を送信します。

Note： 一時的な認証情報の有効期間（デフォルトは3600秒）を制御するには、TemporaryTokenDuration プロパティを設定します。

EC2 Instances

AuthScheme をAwsEC2Roles に設定します。

EC2 インスタンスからconnector を使用していて、そのインスタンスにIAM ロールが割り当てられている場合は、認証にIAM ロールを使用できます。connector は自動的にIAM ロールの認証情報を取得し、それらを使って認証するため、AWSAccessKey およびAWSSecretKey を指定する必要はありません。

認証にIAM ロールも使用している場合は、さらにAWSRoleARN を認証したいロールのRole ARN に設定する必要があります。

IMDSv2 サポート

MySQL connector は、IMDSv2 をサポートしています。IMDSv1 とは異なり、新バージョンでは認証トークンが必須です。エンドポイントおよびレスポンスは、両バージョンで同じです。

IMDSv2 では、MySQL connector はまずIMDSv2 メタデータトークンの取得を試み、それを使用してAWS メタデータエンドポイントを呼び出します。トークンを取得できない場合、connector はIMDSv1 を使用します。

次のステップ

データビジュアライゼーションを作成するには、コネクタの使用を参照してください。

Tableau Connector for MySQL