製品をチェック

無償トライアル:

無償トライアルへ

製品の情報と無償トライアルへ:

CockroachDB ODBC Driver

CockroachDB ODBC Driver を使って、ODBC 接続をサポートするあらゆるアプリケーション・ツールからCockroachDB にデータ連携。

CockroachDB データにデータベースと同感覚でアクセスして、CockroachDB データに使い慣れたODBC インターフェースで双方向連携。

データ連携でお困りですか？

お問い合わせ

記事の内容

関連記事

PHP からCockroachDB にデータ連携。


CData ODBC Driver for CockroachDB を使って、PHP アプリケーションからCockroachDB にデータ連携。PHP でのODBC ネイティブサポートを活用。

cockroachdb ロゴ画像
odbc ロゴ画像

ODBC

PHP ロゴ画像

CData ODBC Driver for CockroachDB は、PHP アプリケーションからのCockroachDB データへの連携を可能にします。本記事では、CockroachDB データをPHP のビルトインODBC 機能でクエリを実行する手順を説明します。

DSN の設定

CockroachDB に接続するDSN を作成します。

  1. まずODBC DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバーのインストール時の最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレータを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。

    Set the following to connect to CockroachDB.

    • Server: The host name or IP address of the server.
    • Port: The port number of the CockroachDB server. If not specified, the default port is 26257.
    • Database: The name of the Cockroach database. If not specified, you connect to the user's default database.
    • User: The Cockroach DB user account used to authenticate.
    • Password: The password used to authenticate the user.

一般的な接続文字列：

User=root;Password=root;Database=system;Server=localhost;Port=26257

ビルトインのデータソースアドミニストレーターでDSN 設定をします。ドライバーのインストールの最後にアドミニストレーターが開きます。ヘルプの「はじめに」でODBC データソースアドミニストレータでCockroachDB に接続するDSN の設定方法を参照してください。

CockroachDB への接続の確立

odbc_connect を呼び出して、CockroachDB への接続を開きます。 odbc_pconnect メソッドでも可能です。コネクションを閉じるには、odbc_close もしくはodbc_close_all を使います。

$conn = odbc_connect("CData ODBC CockroachDB Source","user","password");

コネクションはodbc_connect で開かれ、スクリプトが終わると終了します。odbc_pconnect メソッドで開いたコネクションは、スクリプトが終わっても開いたままです。これにより同じクレデンシャルであれば他のスクリプトでコネクションを共有することが可能です:

$conn = odbc_pconnect("CData ODBC CockroachDB Source","user","password"); ... odbc_close($conn); //persistent connection must be closed explicitly

エレメントの作成

odbc_prepare を使って、Prepared ステートメントおよびパラメータライズドクエリを作成します。

$query = odbc_prepare($conn, "SELECT * FROM Orders WHERE ShipCountry = ?");

クエリの実行

Prepared ステートメントをodbc_execute を使って実行します。

$conn = odbc_connect("CData ODBC CockroachDB Source","user","password"); $query = odbc_prepare($conn, "SELECT * FROM Orders WHERE ShipCountry = ?"); $success = odbc_execute($query, array('USA'));

Non-Parameterized クエリは、odbc_exec を使います。

$conn = odbc_connect("CData ODBC CockroachDB Source","user","password"); $query = odbc_exec($conn, "SELECT * FROM Orders");

結果の処理

odbc_fetch_array ファンクションの結果セット配列としてアクセスします。

$conn = odbc_connect("CData ODBC CockroachDB data Source","user","password"); $query = odbc_exec($conn, "SELECT * FROM Orders"); while($row = odbc_fetch_array($query)){ echo $row["ShipName"] . "\n"; }

odbc_result_all ファンクションで、結果セットをHTML テーブルとして表示します。

$conn = odbc_connect("CData ODBC CockroachDB data Source","user","password"); $query = odbc_prepare($conn, "SELECT * FROM Orders WHERE ShipCountry = ?"); $success = odbc_execute($query, array('USA')); if($success) odbc_result_all($query);

サンプルクエリのテスト

スタンドアロンのテスト環境をたちあげる簡単な方法はPHP のビルトインテストサーバーを使うことです。手順はこちらです：

  1. PHP の最新版のバイナリのダウンロード。

  2. フォルダにファイルを入れる。

  3. フォルダを開く。

  4. php.ini-development をphp.ini に変更。

  5. ブラウザからテストスクリプトにアクセスするためのコマンドを実行。

    php -S localhost:8000 -t C:\path-to-your-scripts -c C:\path-to-php\php.ini

他のサンプルクエリ

サポートされているSQL の詳細は、ヘルプドキュメントを参照してください。上のサンプルは、PHP community documentation for all ODBC functions のCockroachDB に特化したものです。