本記事では CData サポート担当からこんなことを聞かれたらどこを確認すべきか?という観点で、よく頂くお問合せ内容をご紹介します。
記事はこちら →CData ODBC Driver for AzureDevOps は、PHP アプリケーションからのAzure DevOps データへの連携を可能にします。本記事では、Azure DevOps データをPHP のビルトインODBC 機能でクエリを実行する手順を説明します。
Azure DevOps に接続するDSN を作成します。
To generate one, log in to your Azure DevOps Organization account and navigate to Profile -> Personal Access Tokens -> New Token. The generated token will be displayed.
If you wish to authenticate to Azure DevOps using OAuth refer to the online Help documentation for an authentication guide.
一般的な接続文字列:
AuthScheme=Basic;Organization=MyAzureDevOpsOrganization;ProjectId=MyProjectId;PersonalAccessToken=MyPAT;
ビルトインのデータソースアドミニストレーターでDSN 設定をします。ドライバーのインストールの最後にアドミニストレーターが開きます。ヘルプの「はじめに」でODBC データソースアドミニストレータでAzure DevOps に接続するDSN の設定方法を参照してください。
odbc_connect を呼び出して、Azure DevOps への接続を開きます。 odbc_pconnect メソッドでも可能です。コネクションを閉じるには、odbc_close もしくはodbc_close_all を使います。
$conn = odbc_connect("CData ODBC Azure DevOps Source","user","password");
コネクションはodbc_connect で開かれ、スクリプトが終わると終了します。odbc_pconnect メソッドで開いたコネクションは、スクリプトが終わっても開いたままです。これにより同じクレデンシャルであれば他のスクリプトでコネクションを共有することが可能です:
$conn = odbc_pconnect("CData ODBC Azure DevOps Source","user","password");
...
odbc_close($conn); //persistent connection must be closed explicitly
odbc_prepare を使って、Prepared ステートメントおよびパラメータライズドクエリを作成します。
$query = odbc_prepare($conn, "SELECT * FROM Builds WHERE Reason = ?");
Prepared ステートメントをodbc_execute を使って実行します。
$conn = odbc_connect("CData ODBC Azure DevOps Source","user","password");
$query = odbc_prepare($conn, "SELECT * FROM Builds WHERE Reason = ?");
$success = odbc_execute($query, array('Manual'));
Non-Parameterized クエリは、odbc_exec を使います。
$conn = odbc_connect("CData ODBC Azure DevOps Source","user","password");
$query = odbc_exec($conn, "SELECT * FROM Builds");
odbc_fetch_array ファンクションの結果セット配列としてアクセスします。
$conn = odbc_connect("CData ODBC Azure DevOps data Source","user","password");
$query = odbc_exec($conn, "SELECT * FROM Builds");
while($row = odbc_fetch_array($query)){
echo $row["Id"] . "\n";
}
odbc_result_all ファンクションで、結果セットをHTML テーブルとして表示します。
$conn = odbc_connect("CData ODBC Azure DevOps data Source","user","password");
$query = odbc_prepare($conn, "SELECT * FROM Builds WHERE Reason = ?");
$success = odbc_execute($query, array('Manual'));
if($success)
odbc_result_all($query);
スタンドアロンのテスト環境をたちあげる簡単な方法はPHP のビルトインテストサーバーを使うことです。手順はこちらです:
PHP の最新版のバイナリのダウンロード。
フォルダにファイルを入れる。
フォルダを開く。
php.ini-development をphp.ini に変更。
ブラウザからテストスクリプトにアクセスするためのコマンドを実行。
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 のAzure DevOps に特化したものです。