このセクションでは、以下のいくつかのLinux ディストリビューションでODBC 接続をセットアップしDSN を設定する方法を説明します：Ubuntu のようなDebian ベースのシステム、Red Hat Enterprise Linux (RHEL)、およびFedora のようなRed Hat Linux プラットフォーム。

Linux の最小バージョン

Red Hat ベースおよびDebian ベースシステムでサポートされる最小バージョンは以下のとおりです。

OS	Min. Version
Ubuntu	18.04
Debian	10
RHEL	8
Fedora	28
SUSE	15

ドライバー依存関係のインストール

必要な依存関係をインストールするには、次のコマンドをルートとしてまたはsudo で実行します。

• Debian/Ubuntu:
  

  apt-get install libc6 libstdc++6 zlib1g libgcc1

• RHEL/Fedora:
  

  yum install glibc libstdc++ zlib libgcc

ドライバーのインストール

標準のパッケージ管理システムを使用してドライバーをインストールできます。

Ubuntu のようなDebian ベースのシステムでは、次のコマンドをroot またはsudo で実行します。

dpkg -i /path/to/driver/setup/CassandraODBCDriverforUnix.deb 

RPM パッケージ形式をサポートするシステムでは、次のコマンドをroot またはsudo で実行します。

rpm -ivh /path/to/driver/CassandraODBCDriverforUnix.rpm 

ドライバーのライセンス

次のコマンドを実行して本製品 のライセンスを取得します。評価版をアクティベートするには、<key> の入力を省略してください。

cd /opt/cdata/cdata-odbc-driver-for-cassandra/bin/
sudo ./install-license.sh <key>

ドライバーマネージャー経由の接続

ドライバーマネージャーはドライバーをロードし、アプリケーションからドライバーに関数呼び出しを渡します。本製品 をドライバーマネージャーに登録して、ドライバーマネージャーのコンフィギュレーションファイルにDSN を定義する必要があります。

本製品 のインストールでは、本製品 をunixODBC ドライバーマネージャーに登録し、システムDSN を作成します。UnixODBC ドライバーマネージャーは、Python やその他多くのアプリケーションから使用できます。アプリケーションに別のドライバーマネージャーが組み込まれている可能性があります。

DSN の作成

unixODBC をインストールしてDSN を設定するには、unixODBC の使用 を参照してください。OBIEE、Informatica、およびSAS に接続するDSN を作成するには、DataDirect ドライバーマネージャーの使用 を参照してください。

Cassandra への接続

Cassandra インスタンスだけでなく、Cosmos DB やDataStax Astra DB にも、それぞれのCassandra API を介して直接接続できます。

Cassandra

Cassandra インスタンスに接続するには以下を設定します。

• Server：Cassandra データベースをホストしているサーバーのホスト名、またはIP アドレスに設定。ポートは、このプロパティの末尾、またはPort で指定します。
• Port：Server 接続プロパティの一部としてポートを指定していない場合は、Cassandra データベースがホストされているポートに設定。
• Database：テーブルを含むCassandra キースペースの名前に設定。
• ConsistencyLevel：クエリが成功したとみなされる前に、レスポンスを強制したいレプリカの数に設定。
• User：Cassandra データベースへのアクセスに使用するユーザーネームに設定。
• Password：Cassandra データベースへのアクセスに使用するパスワードに設定。

Cosmos DB

Cassandra のデータストアとしてCosmos DB を使用する場合は、以下の値を指定して接続します。

• Server：Host 値（アカウント用にプロビジョニングされたサーバーのFQDN）に設定。ポートは、このプロパティの末尾、またはPort で指定します。
• Port：Server 接続プロパティの一部としてポートを指定していない場合は、Cosmos DB インスタンスがホストされているポートに設定。
• Database：読み書きするデータベースに設定。
• ConsistencyLevel：クエリが成功したとみなされる前に、レスポンスを強制したいレプリカの数に設定。
• User：Cosmos DB アカウント名に設定。
• Password：Cosmos DB アカウントに関連付けられているアカウントキーに設定。

DataStax Astra DB

Cassandra のデータストアとしてAstra DB を使用する場合は、以下の値を指定して接続します。

• Server：BASE_ADDRESS 値でサーバーに設定。ポートもここで指定できます。またはPort で指定します。
• Port：Server 接続プロパティの一部としてポートを指定していない場合は、Astra DB インスタンスがホストされているポートに設定。
• Database：読み書きするデータベースに設定。
• ConsistencyLevel：クエリが成功したとみなされる前に、レスポンスを強制したいレプリカの数に設定。
• User：Astra DB ユーザーネームに設定。
• Password：Astra DB ユーザーネームに紐づいているパスワードに設定。

セキュアバンドル接続

以下の接続プロパティを設定することで、任意の接続をセキュアバンドルとして設定できます。

• Server：サーバー名に設定。
• Port：29042 に設定。
• User：Atra DB ユーザーに設定。
• Password：Astra DB ユーザーパスワードに設定。
• SSLClientCert：identity.jks ファイルへのパスに設定。
• SSLClientCertType：JKSFILE に設定。
• SSLClientCertPassword：identity.jks ファイルのパスワードに設定。
• SSLClientCertSubject：CERTIFICATE SUBJECT INFORMATION に設定。
• UseSSL："true" に設定。

セキュアバンドルに含まれるファイルのリストについてはSecure connect bundle contents を参照してください。

Cassandra への認証

本製品 は、ログイン資格情報でのBasic 認証と、DataStax Enterprise (DSE) の追加の認証機能をサポートしています。次のセクションでは、認証方式が必要とすることがある接続プロパティを説明します。

AuthScheme に、システム用に設定された認証器に対応する値を設定する必要があります。cassandra.yaml ファイル内のauthenticator プロパティを指定してください。ファイルは、通常/etc/dse/cassandra に存在します。または、DSE Cassandra のDSE Unified Authenticator で発見できます。

Basic

ログイン資格情報のみで認証するには、AuthScheme をBasic に設定します。

cassandra.yaml ファイル内で、authenticator プロパティを"PasswordAuthenticator" に設定してください。

DSE

AuthScheme プロパティを、ログイン資格情報とDSE Unified Authenticator で認証するためのDSE に設定。

ファイル内で、authenticator プロパティを"com.datastax.bdp.cassandra.auth.DseAuthenticator" に設定してください。

Kerberos

Kerberos で認証するには以下のように設定します。

• AuthScheme：KERBEROS に設定。
• KerberosKDC：ユーザーの認証で使用されるKerberos キー配布センター（KDC）サービスに設定。
• KerberosRealm：ユーザー認証に使用されるKerberos 領域に設定。
• KerberosSPN：Kerberos ドメインコントローラーのサービスプリンシパル名（SPN）に設定。

次に、これらのYAML ファイルを以下のように設定します。

• cassandra.yaml ファイル内で、authenticator プロパティを"com.datastax.bdp.cassandra.auth.DseAuthenticator" に設定してください。
• dse.yaml ファイル内のauthentication_options セクションを変更して、default_schema とother_schemas プロパティを"kerberos" に指定してください。
• dse.yaml ファイル内のkerberos_options セクションを変更して、keytab、service_principle、http_principle、およびqop プロパティを指定してください。

Kerberos に接続するために接続プロパティを設定する方法については、Kerberos の使用 を参照してください。

LDAP

認証するには以下のように設定します。

• AuthScheme：LDAP ユーザーで認証するには、これをLDAP に設定。
• LDAPServer：LDAP サーバーのホスト名またはIP アドレスに設定。
• LDAPPassword：デフォルトLDAP ユーザーのパスワード。

次に、これらのYAML ファイルを以下のように設定します。

• cassandra.yaml ファイル内で、authenticator プロパティを"com.datastax.bdp.cassandra.auth.DseAuthenticator" に設定してください。
• dse.yaml ファイル内のauthentication_options セクションを変更して、default_schema とother_schemas プロパティを"ldap" に指定してください。
• dse.yaml ファイル内のldap_options セクションを変更して、server_host、server_port、search_dn、search_password、user_search_base、およびuser_search_filter プロパティを指定してください。

セキュアなCassandra への接続

UseSSL を設定すると、接続時にSSL/TLS 暗号化をネゴシエートできます。 デフォルトでは、本製品 はサーバーの証明書をシステムの信頼できる証明書ストアと照合してSSL/TLS のネゴシエーションを試みます。別の証明書を指定するには、利用可能なフォーマットについてSSLServerCert プロパティを参照してください。

ドライバーエンコーディングの設定

ODBC ドライバーは、ODBC ドライバーマネージャーで使用するエンコーディングを指定する必要があります。デフォルトでは、Unix 用のCData ODBC ドライバーはunixODBC と互換性のあるUTF-16 を使用するように設定されていますが、他のドライバーマネージャーでは代替エンコーディングが必要な場合があります。

また、ANSI ODBC API を使用するアプリケーションからODBC ドライバーを使用している場合は、ANSI コードページを設定する必要があります。例えば、ANSI アプリケーションに日本語の文字をインポートするには、設定ファイル'/opt/cdata/cdata-odbc-driver-for-cassandra/lib/cdata.odbc.cassandra.ini' でコードページを指定できます。

[Driver]
AnsiCodePage = 932