ODBC Driver for Cassandra

Build 24.0.8963

macOS DSN の構成

このセクションでは、macOS でODBC 接続をセットアップしDSN を設定する方法を示します:

macOS の最小バージョン

CData ODBC Driver for Cassandra 本製品 にはmacOS Sierra (10.12) 以上が必要です。

ドライバーのライセンス

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

cd "/Applications/CData ODBC Driver for Cassandra/bin"
sudo ./install-license.sh <key>

名前とパスワードを入力するよう求められます。これらは、あなたの名前とマシンのパスワードを指します。

Cassandra への接続

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

Cassandra

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

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

Cosmos DB

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

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

DataStax Astra DB

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

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

セキュアバンドル接続

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

  • Server:サーバー名に設定。
  • Port29042 に設定。
  • User:Atra DB ユーザーに設定。
  • Password:Astra DB ユーザーパスワードに設定。
  • SSLClientCert:identity.jks ファイルへのパスに設定。
  • SSLClientCertTypeJKSFILE に設定。
  • SSLClientCertPassword:identity.jks ファイルのパスワードに設定。
  • SSLClientCertSubjectCERTIFICATE 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

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

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

DSE

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

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

Kerberos

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

  • AuthSchemeKERBEROS に設定。
  • KerberosKDC:ユーザーの認証で使用されるKerberos キー配布センター(KDC)サービスに設定。
  • KerberosRealm:ユーザー認証に使用されるKerberos 領域に設定。
  • KerberosSPN:Kerberos ドメインコントローラーのサービスプリンシパル名(SPN)に設定。
次に、これらのYAML ファイルを以下のように設定します。
  • cassandra.yaml ファイル内で、authenticator プロパティを"com.datastax.bdp.cassandra.auth.DseAuthenticator" に設定してください。
  • dse.yaml ファイル内のauthentication_options セクションを変更して、default_schemaother_schemas プロパティを"kerberos" に指定してください。
  • dse.yaml ファイル内のkerberos_options セクションを変更して、keytabservice_principlehttp_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_schemaother_schemas プロパティを"ldap" に指定してください。
  • dse.yaml ファイル内のldap_options セクションを変更して、server_hostserver_portsearch_dnsearch_passworduser_search_base、およびuser_search_filter プロパティを指定してください。

セキュアなCassandra への接続

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

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

ドライバーをアンインストールする最も簡単な方法は、ターミナルを開いて、インストールディレクトリにあるuninstall.sh スクリプトを実行します。次に例を示します。

cd "/Applications/CData ODBC Driver for Cassandra"
sudo ./uninstall.sh

Note:このスクリプトはインストールディレクトリから実行される必要があります。

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.8963