ODBCを使用したデータ・フローSQLエンドポイントへのTableauの接続
Tableauをデータ・フローSQLエンドポイントに接続するために、MAC OSまたはWindowsでODBCをダウンロード、インストールおよび構成します。
Mac OSでのODBCドライバのダウンロードとインストール
Mac OSでTableauで使用するODBCドライバをダウンロードしてインストールするには、次のステップに従います。
-
ODBCドライバをダウンロードします。
- グローバル検索バーで、
Data Flow
を検索し、「データ・フロー・サービス」を選択します。 - 左端のナビゲーションで「SQLエンドポイント」を選択します。
- リストから任意のSQLエンドポイントを選択します。そのSQLエンドポイントの詳細ページが表示されます。
- 「接続」で、「ドライバ」を選択します。
- 「ODBC」で、「ODBCドライバのダウンロード」を選択します。
- 「Mac」を選択します。ダウンロードが始まります。
- ダウンロードが完了したら、ダウンロードしたzipファイルを解凍します。
- グローバル検索バーで、
-
ダブルクリックしてドライバをインストールします。
インストール・ウィンドウが開きます。
-
「続行」を選択します。
表示されているライセンス契約を確認します。
- 「同意」を選択します。
- (オプション)インストール・ディレクトリをデフォルトから変更するには、「インストール場所の変更」を選択し、インストール先を参照して「OK」を選択します。
- 「次へ」を選択して、インストール・ディレクトリを確認します。
- 「Install」を選択します。
-
インストールが完了したら、「終了」を選択します。
ドライバのインストールディレクトリは次のとおりです。
/Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
- (オプション)ODBCマネージャをインストールします。
ODBC Managerは、ドライバを構成し、DSNを作成および管理するためのツールです。適切な
odbc.ini
ファイルを編集してDSNを手動で作成できるため、ツールはオプションです。- ダウンロード・サイトからODBCマネージャをダウンロードします。
- ダウンロードした
.dmg
ファイルをダブルクリックします。 ODBC Manager.pkg
ファイルをダブルクリックします。- プロンプトに従ってインストールします。
Mac OSでのODBCドライバの構成
Mac OSでODBCドライバを構成するには、次のステップに従います。
ユーザーDSN(ワークステーションで作成したユーザーのみにアクセス可能)またはシステムDSN(ワークステーションにサインインしたユーザーがアクセスできる)を作成できます。
-
接続先のSQLエンドポイントのホスト名を取得します。
- SQLエンドポイントがアクティブな場合は、その詳細ページを開きます。
- 「ドライバ」を選択します。
- 「ODBCドライバ」で、「詳細の表示」を選択します。ポップアップが現れます。
- 「ホスト名」文字列で「表示」を選択します。完全なホスト名が表示されます。
- 「ホスト名」文字列で「コピー」を選択します。完全なホスト名がクリップボードにコピーされます。
- 後で使用するためにホスト名を保存します。
- (オプション)ODBCマネージャを使用してDSNを作成します。
-
ODBC Managerを起動します。
-
必要に応じて、「ユーザーDSN」または「システムDSN」を選択します。
-
「追加」を選択します。
-
Simba OCI Spark ODBC Driver
を選択します。 -
「OK」をクリックします。
-
DSNの名前(
Data Flow SQL Endpoint
など)を入力し、オプションで説明を追加します。 -
DSNパラメータごとにキーワード値のペアを作成します。
-
「追加」を選択して、キーワード値のペアを作成します。
-
「キーワード」を選択し、パラメータ名に置き換えます。
-
「値」を選択し、パラメータの値に置き換えます。
- パラメータごとにステップgからjを繰り返します。
- 接続認証の詳細を追加します。
- デフォルトの場所
~/.oci/config
にないAPI署名キーを使用してSQLエンドポイントに接続するには、次のパラメータを追加します。OCIConfigFile=ConfigFileLocation
ConfigFileLocation
は、接続で使用するOCI構成ファイルへの絶対パスです。オプションで、OCIProfileフィールドを、接続で使用する構成ファイル内のOCIプロファイルの名前に設定します。
プロファイルが指定されていない場合、コネクタはDEFAULTという名前のプロファイルを使用しようとします。OCIProfile=<profile_to_use>
OCIProfile=<profile_to_use>
- (ブラウザを介して)トークンを使用してSQLエンドポイントに接続する場合は、DSN構成から
OCIConfigFile
パラメータを省略します。
- デフォルトの場所
-
「OK」を選択してDSNを作成します。
ノート
ODBCドライバの最初のユーザーまたはシステムDSNを作成した場合、ODBC Managerは、作成されたDSNのタイプに対応するディレクトリにodbc.ini
ファイルを作成します。DSNをさらに作成すると、ODBC Managerは各DSNのエントリを既存のodbc.ini
ファイルに追加します。odbc.ini
ファイルは、ユーザーDSNの場合は~/Library/ODBC
ディレクトリ、システムDSNの場合は/Library/ODBC
ディレクトリにあります。 -
- (オプション)
odbc.ini
にエントリを追加してDSNを作成します。ユーザーDSNまたはシステムDSNがすでにドライバ用に作成されている場合は、新しいエントリを既存のodbc.ini
ファイルに追加します。ドライバの最初のDSNを作成する場合は、odbc.ini
ファイルを手動で作成し、ファイルにエントリを追加します。- 空の
odbc.ini
ファイルに最初のDSNを作成する場合は、odbc.ini
ファイルに次の行を追加して、ODBCデータ・ソースのセクションを(初めてのみ)作成します。[ODBC Data Sources]
-
DSNごとに、次を指定します。
[ODBC Data Sources]
で、DSN名とODBCドライバ名(Simba OCI Spark ODBCドライバ)を<dsn_name> = <driver_name>
の形式で指定します。例:[ODBC Data Sources]dsn_name = Simba OCI Spark ODBC Driver
- ファイルの最後にある新しい行に
[dsn_name]
を追加して、DSN構成のセクションを作成します。[dsn_name]
- 作成したDSNセクションで、ドライバ・ファイルのディレクトリ・パスを次の形式で指定します。
Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
-
ホストや構成ファイルなどの接続パラメータを指定します。DSNに追加する接続パラメータは、ODBC接続文字列で指定する必要はありません。
- API署名キー(
~/.oci/config
のデフォルトの場所ではなく)を使用してSQLエンドポイントに接続するには、次のパラメータを追加します。OCIConfigFile=ConfigFileLocation
ConfigFileLocation
は、接続に使用するOCI構成ファイルへの絶対パスです。オプションで、
OCIProfile
フィールドを、接続に使用する構成ファイル内のOCIプロファイルの名前に設定します。プロファイルが指定されていない場合、コネクタはDEFAULT
という名前のプロファイルを使用しようとします。OCIProfile=PROFILE_TO_USE
- トークン(ブラウザベース)を使用してSQLエンドポイントに接続するには、DSN構成から
OCIConfigFile
パラメータを省略できます。
- API署名キー(
- その他のパラメータは、
<parameter_name> = <value>.
の形式で指定します。次の例は、APIキーを使用してデータ・ソースを構成するodbc.ini
ファイルを示しています。[ODBC Data Sources] Data Flow SQL Endpoint = Simba OCI Spark ODBC Driver [Data Flow SQL Endpoint] Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib Description = Description of the connection Host = amaaaaaaezym32iajmhpmxybehc7plnvpxsmjhleiav37x5rm7pjx476ewqa.interactive.dataflowclusters.us-ashburn-1.oci.oc-test.com OCIConfigFile = /Users/username/.oci/config OCIProfile = OCIProfileToUse OCIIgnoreDriverNoPrompt = 1
- 認証にAPI署名キーを使用するOCI構成ファイルのパスが正しいことを確認します。
- 構成内の秘密キー・ファイル・パスを検証します。
- 空の
WindowsでのODBCのダウンロードとインストール
Windows/でTableauで使用するODBCドライバをダウンロードしてインストールするには、次のステップに従います
-
から Windows ODBCドライバをダウンロードします。
- グローバル検索バーで、
Data Flow
を検索し、「データ・フロー・サービス」を選択します。 - 左端のナビゲーションで「SQLエンドポイント」を選択します。
- リストから任意のSQLエンドポイントを選択します。そのSQLエンドポイントの詳細ページが表示されます。
- 「接続」で、「ドライバ」を選択します。
- 「ODBC」で、「ODBCドライバのダウンロード」を選択します。
- 「Windows」を選択します。ダウンロードが始まります。
- ダウンロードが完了したら、ダウンロードしたzipファイルを解凍します。
- グローバル検索バーで、
-
.zip
ファイルを抽出します。 -
32ビット・インストーラ
Simba OCI Spark 2.6 32-bit.msi
をダブルクリックします(システムが32ビットの場合)、または64ビット・インストーラSimba OCI Spark 2.6 64-bit.msi
をダブルクリックします(システムが64ビットの場合)。 - 「次」を選択します。
- 利用規約に同意します。
- 「次」を選択します。
- (オプション)インストール・ディレクトリをデフォルトから変更するには:
- 「変更」を選択します。
- 必要なディレクトリを参照します。
- 「OK」をクリックします。
- インストール・ディレクトリを受け入れるには、「次へ」を選択します。
- 「Install」を選択します。
- インストールが完了したら、「終了」を選択します。
WindowsでのODBCドライバの構成
WindowsでODBCドライバを構成するには、次のステップに従います。
ユーザーDSN(ワークステーションで作成したユーザーのみにアクセス可能)またはシステムDSN(ワークステーションにサインインしたユーザーがアクセスできる)を作成できます。
-
接続先のSQLエンドポイントのホスト名を取得します。
- SQLエンドポイントがアクティブな場合は、その詳細ページを開きます。
- 「ドライバ」を選択します。
- 「ODBCドライバ」で、「詳細の表示」を選択します。ポップアップが現れます。
- 「ホスト名」文字列で「表示」を選択します。完全なホスト名が表示されます。
- 「ホスト名」文字列で「コピー」を選択します。完全なホスト名がクリップボードにコピーされます。
- 後で使用するためにホスト名を保存します。
-
DSNを作成します。
-
ODBCデータ・ソース・アプリケーションを開きます。
-
必要に応じて、「ユーザーDSN」または「システムDSN」を選択します。
-
「追加」を選択します。
-
Simba OCI Spark ODBC Driver
を選択します。 -
「終了」を選択します。
-
DSNの名前(
Data Flow SQL Endpoint
など)を入力し、オプションで説明を追加します。 -
認証では、API署名キーを使用してSQLエンドポイントに接続するか、トークン(ブラウザベース)を使用してSQLエンドポイントに接続できます。
- API署名キーを使用するには
-
- OCI構成ファイルを、接続に使用するOCI構成ファイルへの絶対パスに設定します。
- オプションで、「OCIプロファイル」フィールドに、接続に使用するOCIプロファイルの名前を設定します。プロファイルが指定されていない場合、コネクタは
DEFAULT
という名前のプロファイルを使用しようとします。 - 「Ignore SQL_DRIVER_NOPROMPT」を選択します。
- 「OK」を選択して設定を保存します。
- トークンを使用するには(ブラウザベース)
- DFIオプションを完全に設定せず、DSN(ステップiv)のみをテストするか、「DFIオプション」を選択して次のステップを続行するかを選択できます。
- 「OCI構成ファイル」フィールドを、トークンベースの認証を使用するOCI構成ファイルを含まないパスに設定します。
SQL_DRIVER_NOPROMPT
が有効な場合でも、トークンベースの認証フローの完了に使用されるWebブラウザを表示するには、「SQL_ DRIVER_NOPROMPTを無視」を選択します。- 「OK」を選択して設定を保存します。
- DSNをテストするには、「テスト」を選択します。
-
「OK」を選択してDSNを作成します。
-
ODBCを使用したTableauのデータ・フローSQLエンドポイントへの接続
ODBCを使用してTableauをデータ・フローSQLエンドポイントに接続するには、次のステップに従います。
- Tableauを開きます。
-
「その他のデータベース(ODBC)」を選択します。
新しいウィンドウが開きます。
- DSNを確認します。
-
リストからDSN
Data Flow SQL Endpoint
を選択します。必要なすべての接続パラメータが自動的に移入されます。 - 「サイン・イン」を選択します。