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」をクリックします。
- 「次へ」をクリックして、インストール・ディレクトリを確認します。
- 「インストール」をクリックします。
-
インストールが完了したら、「終了」をクリックします。
ドライバのインストールディレクトリは次のとおりです。
/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エンドポイントがアクティブになったら、その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マネージャは、作成されたDSNのタイプに対応するディレクトリにODBC.ini
ファイルを作成します。さらにDSNを作成すると、ODBCマネージャによって各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構成のセクションを作成するには、ファイルの末尾に新しい行に
[dsn_name]
を追加します。[dsn_name]
- 作成されたDSNセクションで、ドライバ・ファイルのディレクトリ・パスを次の形式で指定します。
Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
-
ホストや構成ファイルなどの接続パラメータを指定します。DSNに追加する接続パラメータは、ODBC接続文字列で指定する必要はありません。
- (
~/.oci/config
のデフォルトの場所ではなく) API署名キーを使用してSQLエンドポイントに接続するには、パラメータを追加します:OCIConfigFile=ConfigFileLocation
ConfigFileLocation
は、接続に使用するOCI構成ファイルへの絶対パスです。オプションで、
OCIProfile
フィールドを、接続に使用する構成ファイル内のOCIプロファイルの名前に設定します。プロファイルが指定されていない場合、コネクタはDEFAULT
という名前のプロファイルを使用しようとします。OCIProfile=PROFILE_TO_USE
- トークン(ブラウザベース)を使用してSQLエンドポイントに接続するには、DSN構成から
OCIConfigFile
パラメータを省略します。
- (
- その他のパラメータは、
<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ビットである場合は32ビットインストーラ
Simba OCI Spark 2.6 32-bit.msi
をダブルクリックするか、システムが64ビットである場合は64ビットインストーラSimba OCI Spark 2.6 64-bit.msi
をダブルクリックします。 - 「次へ」をクリックします。
- ライセンス契約の条件に同意します。
- 「次へ」をクリックします。
- (オプション) インストールディレクトリをデフォルトから変更するには:
- 「変更」...をクリックします。
- 必要なディレクトリを参照します。
- 「OK」をクリックします。
- インストール・ディレクトリを受け入れるには、「次」をクリックします。
- 「インストール」をクリックします。
- インストールが完了したら、「終了」をクリックします。
WindowsでのODBCドライバの構成
WindowsでODBCドライバを構成するには、次のステップに従います。
ユーザーDSN(ワークステーションで作成したユーザーのみがアクセス可能)またはシステムDSN(ワークステーションにサインインしたユーザーがアクセス可能)を作成できます。
-
接続先のSQLエンドポイントのホスト名を取得します。
- 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
という名前のプロファイルを使用しようとします。 - 「SQL_DRIVER_NOPROMPTを無視」を選択します。
- 「OK」をクリックして設定を保存します。
- トークンを使用するには(ブラウザベース)
- DFIオプションを完全に設定せず、DSN (ステップiv)のみをテストするか、「DFIオプション」をクリックして次のステップを続行できます。
- 「OCI構成ファイル」フィールドを、トークンベースの認証を使用するOCI構成ファイルを含まないパスに設定します。
SQL_DRIVER_NOPROMPT
が有効な場合でもトークンベースの認証フローを完了するために使用されるWebブラウザを表示するには、「SQL_を無視」DRIVER_NOPROMPTを選択します。- 「OK」をクリックして設定を保存します。
- DSNをテストするには、「テスト」をクリックします。
-
「OK」をクリックしてDSNを作成します。
-
ODBCを使用したデータ・フローSQLエンドポイントへのTableauの接続
ODBCを使用してTableauをデータ・フローSQLエンドポイントに接続するには、次のステップに従います。
- Tableauを開きます。
-
「その他のデータベース(ODBC)」をクリックします。
新しいウィンドウが開きます。
- DSNを確認します。
-
リストからDSN
Data Flow SQL Endpoint
を選択します。必要なすべての接続パラメータが自動的に移入されます。 - サインインをクリックします。