システム DSN の作成

• BI Connectorをインストールし、レプリカセットに接続するように設定します。

  注意

  BI Connector for Atlas を使用している場合、この前提条件は該当しません。

• Visual Studio2015 用 Visual C++ 再頒布可能パッケージ をダウンロードしてインストールします。

• MongoDB BI Connector ODBC ドライバーをダウンロードしてインストール。

• BI Connectorをインストールし、レプリカセットに接続するように設定します。

  注意

  BI Connector for Atlas を使用している場合、この前提条件は該当しません。

• MongoDB BI Connector ODBC ドライバーをダウンロードしてインストール。

• BI ConnectorをRed Hat Enterprise ベースの LinuxまたはDebian ベースの Linuxにインストールし、レプリカセットに接続するように設定します。

  注意

  BI Connector for Atlas を使用している場合、この前提条件は該当しません。

• 利用中のプラットフォームに対応した MongoDB BI Connector ODBC ドライバーをダウンロードして展開します。

1. Microsoft ODBC データソース プログラムを起動します。

   システムと ODBC ドライバーのバージョンに適したプログラム バージョン (64 ビットまたは 32 ビット) を選択します。

2. System DSN タブを選択します。

3. Addボタンをクリックします。

   

   クリックして拡大します

4. 使用可能なドライバーのリストから MongoDB BI Connector ODBC ドライバーを選択します。

   MongoDB ODBC ANSI DriverまたはMongoDB ODBC Unicode Driverのいずれかを選択し、 OKをクリックします。

   注意

   ANSI ODBC ドライバーは最大限のパフォーマンスを提供しますが、文字セットは制限されています。Unicode ODBCドライバーはより幅広い文字セットをサポートしますが、その結果パフォーマンスが若干低下する可能性があります。

5. 必要なフォームフィールドに入力します。

   Details ボタンをクリックすると、フォームの下半分が表示されます。

   次のフォーム フィールドは必須です。

   フィールド名	説明
   Data Source Name	名前は自由に設定できます。
   TCP/IP Server	mongosqld プロセスが実行されているサーバーのアドレスです。MongoDB Atlas で BI Connector を有効にしている場合は、クラスターの接続情報で、mongosqldが実行されているサーバーのホスト名を見つけることができます。
   Port	mongosqld プロセスのポート番号。
   Database	接続するデータベースの名前（例：test）

6. （オプション）認証が有効になっている場合は、接続情報を提供します。

   --auth を有効にして実行する場合、または BI Connector for Atlas インスタンスに接続する場合は、次のフィールドが必須です。

   フィールド名	説明
   User	ターゲット データベースを使用するために認証されるMongoDB ユーザーのユーザー名。 ユーザー名の後に URI スタイルのクエリ パラメーターとして次の認証オプションを指定できます。 接続オプション 説明 source ユーザーの認証情報をストアするデータベースの名前を指定します。このオプションを指定しない場合、MongoDB Connector for BI はデフォルトで MySQL 接続に関連付けられた現在のデータベースになります。 PLAIN（LDAP）や GSSAPI（Kerberos）など、認証情報ストレージを他のサービスに委任する認証メカニズムの場合は、source 値を $external に設定します。 MongoDB Connector for BI 構成ファイルで defaultSource が設定されている場合は必要ありません。 mechanism MongoDB Connector for BI が接続の認証に使用するメカニズムを指定します。受け入れ可能な値は以下の通りです。 SCRAM-SHA- 1 （デフォルト） SCRAM-SHA-256 PLAIN（LDAP SASL） GSSAPI（Kerberos） LDAP と Kerberos にはMongoDB Enterpriseが必要です。 LDAP または Kerberos を使用する場合は、ソースを$externalに設定します。 MongoDB Connector for BI 構成ファイルで defaultMechanism が設定されている場合は必要ありません。 X.509 はサポートされていません。 ユーザー名とパスワード LDAP Kerberos たとえば、 adminデータベースと Challenge および Response（ SCRAM-SHA-1 ）認証メカニズムを使用してユーザーgraceとして認証するには、次の形式でユーザー名を書き込みます。 grace?source=admin たとえば、 LDAP （ PLAIN ）認証メカニズムを使用してユーザーgraceとして認証するには、次の形式でユーザー名を書き込みます。 grace?mechanism=PLAIN&source=$external たとえば、 Kerberos レルム でユーザーgrace として認証するにはEXAMPLE.COM Kerberos 認証メカニズムを使用する場合は、ユーザー名を次の形式で書き込みます。 grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external Kerberos 構成の詳細については、「 BI Connector 用の Kerberos の構成 」を参照してください。
   Password	認証されたユーザーのパスワード。 データベース パスワードでは中括弧（ { } ）を使用できません。これらはODBCドライバーの特殊文字であるためです。
   Authentication	デフォルトの認証方法。MongoDB BI Connector ODBC Driver を使用する場合、このフィールドは必須ではありません。 認証プラグインを別の ODBC ドライバーと組み合わせて使用するには、このフィールドに文字列 mongosql_auth を入力します。

7. （オプション）TLS/SSL が有効になっている場合は、TLS/SSL フォーム フィールドに入力します。

   Details >>をクリックし、次にSSLタブをクリックして、TLS/SSL フォーム フィールドにアクセスします。次のパラメータが使用できます。 TLS/SSL の構成によっては、必須となる場合があります。

   フィールド名	説明
   SSL Key	クライアント/サーバー キー ファイルの場所。
   SSL Cert	クライアント/サーバ証明書ファイルの場所。
   SSL CA File	信頼された認証局のリストを含むファイルの場所。
   SSL Cipher	許可された暗号のリストを含むファイルの場所。
   SSL Mode	暗号化されたチャンネルが必要な場合はREQUIREDに設定します。encirpted チャンネルが提供されない場合、接続が失敗します。
   RSA Public Key	RSA 公開キーを含む PEM ファイルの場所。

   注意

   BI Connector for Atlas はTLS/SSL を使用しますが、システム DSN で TLS/SSL 設定を構成する必要はありません。

8. ODBC 接続をテストするには、Test ボタンをクリックします。

   接続が成功した場合は、 OK をクリックして DSN を追加します。接続が失敗した場合は、MongoDB ユーザーが接続で指定したデータベースで正しく認証されているかどうかを確認します。

1. ODBC マネージャーを起動します。

   注意

   ODBC Manager は MongoDB BI Connector ODBC ドライバーに含まれています。

   重要

   ODBC Manager 1.0.16 エディション（MongoDB BI Connector ODBC ドライバー に付属）は、Catalina 以降のバージョンの macOS と互換性がありません。Catalina 以降のバージョンの macOS を使用している場合は、ODBC マネージャーの最新バージョン（1.0.19）をダウンロードし、インストールしてください。

2. [System DSN をクリックし、[Add] をクリックします。

   

3. 使用可能なドライバーのリストから MongoDB BI Connector ODBC ドライバーを選択します。

   MongoDB ANSI ODBC ドライバーまたは MongoDB Unicode ODBC ドライバーのいずれかを選択し、OK をクリックします。

   注意

   ANSI ODBC ドライバーは最大限のパフォーマンスを提供しますが、文字セットは制限されています。Unicode ODBCドライバーはより幅広い文字セットをサポートしますが、その結果パフォーマンスが若干低下する可能性があります。

4. Data Source Name (DSN)と入力します。

   オプションでDescriptionを入力します。

   注意

   設定ウィンドウを閉じないでください。次の手順に進みます。

5. 必要なキーワードを追加します。

   1. Add ボタンをクリックしてキーワードと値のペアを追加します。

   2. Keywordをダブルクリックして、目的のキーワードを入力し、 Enter キーを押して、 を変更します。

   3. Valueをダブルクリックして、目的のキーワードを入力し、 Enter キーを押して、 を変更します。

   上記の手順を使用して、次のキーワードを追加します。

   Keyword	値
   サーバー	MongoDB Connector for BI ホストのホスト名または IP アドレス。 重要: TCP を使用してローカルホストに接続するには、 127.0.0.1を使用します。 IPアドレス以外の値を指定すると、 BI Connector は Unix ソケットを使用して接続を試みます。
   ポート	IANA ポート番号 : MongoDB Connector for BI 用。デフォルトは3307です。
   DATABASE	接続後に使用するデータベース。 Microsoft Excel に接続するときは、このキーワードを使用する必要があります。

   ODBCパラメータの完全なリストについては、 Connector/ODBC接続パラメータ を参照してください。

   例としては、ユーザーの DSN 構成は次のようになります。

   

   注意

   設定ウィンドウを閉じないでください。次の手順に進みます。

6. （オプション）認証が有効になっている場合は、認証キーワードを追加します。

   1. Add ボタンをクリックしてキーワードと値のペアを追加します。

   2. Keywordをダブルクリックして、目的のキーワードを入力し、 Enter キーを押して、 を変更します。

   3. Valueをダブルクリックして、目的のキーワードを入力し、 Enter キーを押して、 を変更します。

   上記の手順を使用して、次のキーワードを追加します。

   Keyword	値
   UID	アクティブな MongoDB Connector for BI データベースにアクセスできるユーザーのユーザー名。 ユーザー名の後に URI スタイルのクエリ パラメーターとして次の認証オプションを指定できます。 接続オプション 説明 source ユーザーの認証情報をストアするデータベースの名前を指定します。このオプションを指定しない場合、MongoDB Connector for BI はデフォルトで MySQL 接続に関連付けられた現在のデータベースになります。 PLAIN（LDAP）や GSSAPI（Kerberos）など、認証情報ストレージを他のサービスに委任する認証メカニズムの場合は、source 値を $external に設定します。 MongoDB Connector for BI 構成ファイルで defaultSource が設定されている場合は必要ありません。 mechanism MongoDB Connector for BI が接続の認証に使用するメカニズムを指定します。受け入れ可能な値は以下の通りです。 SCRAM-SHA- 1 （デフォルト） SCRAM-SHA-256 PLAIN（LDAP SASL） GSSAPI（Kerberos） LDAP と Kerberos にはMongoDB Enterpriseが必要です。 LDAP または Kerberos を使用する場合は、ソースを$externalに設定します。 MongoDB Connector for BI 構成ファイルで defaultMechanism が設定されている場合は必要ありません。 X.509 はサポートされていません。 ユーザー名とパスワード LDAP Kerberos たとえば、 adminデータベースと Challenge および Response（ SCRAM-SHA-1 ）認証メカニズムを使用してユーザーgraceとして認証するには、次の形式でユーザー名を書き込みます。 grace?source=admin たとえば、 LDAP （ PLAIN ）認証メカニズムを使用してユーザーgraceとして認証するには、次の形式でユーザー名を書き込みます。 grace?mechanism=PLAIN&source=$external たとえば、 Kerberos レルム でユーザーgrace として認証するにはEXAMPLE.COM Kerberos 認証メカニズムを使用する場合は、ユーザー名を次の形式で書き込みます。 grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external Kerberos 構成の詳細については、「 BI Connector 用の Kerberos の構成 」を参照してください。
   PWD	UIDに関連付けられたパスワード。 データベース パスワードでは中括弧（ { } ）を使用できません。これらはODBCドライバーの特殊文字であるためです。

   ODBCパラメータの完全なリストについては、 Connector/ODBC接続パラメータ を参照してください。

   例としては、ユーザーの DSN 構成は次のようになります。

   

7. （オプション）TLS/SSL が有効な場合は、TLS/SSL キーワードを追加します。

   1. Add ボタンをクリックしてキーワードと値のペアを追加します。

   2. Keywordをダブルクリックして、目的のキーワードを入力し、 Enter キーを押して、 を変更します。

   3. Valueをダブルクリックして、目的のキーワードを入力し、 Enter キーを押して、 を変更します。

   注意

   BI Connector for Atlas はTLS/SSL を使用しますが、システム DSN で TLS/SSL 設定を構成する必要はありません。

   上記の手順を使用して、TLS/SSL 構成に応じて次のキーワードを追加します。

   Keyword	値
   SSLKEY	.pem へのパスキーファイル。
   SSLCERT	SSL 証明書へのパス。
   SSLMODE	REQUIRED に設定します。
   SSLCA	SSL 認証局ファイルへのパス。
   SSLCIPHER	許可された暗号のリストを含むファイルへのパス。
   RSAKEY	RSA 公開キーを含む PEM ファイルへのパス。
   ENABLE_CLEARTEXT_PLUGIN	cleartext 認証を有効にするには 1 を設定します。

   注意

   Microsoft Excel を使用して接続する場合、証明書が/Library/ODBC/ディレクトリに配置されている必要があります。

   ODBCパラメータの完全なリストについては、 Connector/ODBC接続パラメータ を参照してください。

   例としては、ユーザーの DSN 構成は次のようになります。

   

8. [ OKをクリックして DSN の作成を終了します。

次の手順は Ubuntu と RHEL でテストされており、他の Linux ディストリビューションでも同様の方法で動作すると考えられます。

[MongoDBODBC]
DESCRIPTION = ODBC for MongoDB BI Connector
DRIVER      = /usr/local/lib/libmdbodbcw.so
TRACE       = Off
TRACEFILE   = stderr
READONLY    = yes
SERVER      = <server address>
PORT        = <port number>
USER        = <username>
PASSWORD    = <password>
DATABASE    = <dbname>
; optional SSL configuration
SSLKEY      = </path/to/.pem-key-file>
SSLCERT     = </path/to/ssl-certificate>
SSLMODE     = DISABLED|PREFERRED|REQUIRED
SSLCA       = </path/to/ssl-ca-list-file>
SSLCAPATH   = </path/to/ssl-ca-file-directory>
SSLCIPHER   = </path/to/ssl-cipher-file>
RSAKEY      = </path/to/rsa-public-key-file>

sudo apt-get install unixodbc

sudo yum install unixODBC

iusql -v MongoDBODBC

SQL> use test;
SQL> show tables;