ODBC 経由で PowerBuilder から Linear のデータ に接続

CData ODBC Driver for Linear は、ODBC をサポートするあらゆるプラットフォームや開発技術から使用できます。PowerBuilder もその一つです。この記事では、Linear のデータ に接続し、Database Painter や DataWindow などのコントロールからクエリを実行する方法を説明します。

Linear にODBC データソースとして接続

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して、ODBC DSN を作成・設定できます。

Linear への認証には、個人用 API キーまたは OAuth 2.0 を使用できます。ご自身の Linear アカウントで接続する場合は、API キーを使うのが最も手軽です。

API キーによる認証

以下の接続プロパティを設定します。

• AuthScheme：APIKey に設定します。
• APIKey：Linear の個人用 API キー。

個人用 API キーを作成するには、Linear にログインして Settings > Security & access > Personal API keys を開き、New API key を選択して作成します。キーは一度しか表示されないため、すぐにコピーしておきましょう。

OAuth による認証

OAuth を使用するには、Linear にカスタム OAuth アプリケーションを登録する必要があります（Settings > API > OAuth applications）。登録すると OAuthClientId と OAuthClientSecret が発行されます。対応しているフローは以下の 2 つです。

• Authorization code：AuthScheme を OAuth、InitiateOAuth を GETANDREFRESH に設定し、OAuthClientId、OAuthClientSecret、およびアプリケーションで定義した CallbackURL（例：http://localhost:33333）を指定します。ドライバーがブラウザで Linear を開くので、アクセスを許可してください。
• Client credentials：AuthScheme を OAuthClient に設定し、OAuthClientId と OAuthClientSecret を指定します。アプリケーション自体を認証するためブラウザ操作は不要で、マシン間（M2M）連携に適しています。

デフォルトでは、ドライバーは read,write スコープをリクエストします。アクセストークンは有効期限が切れると自動で更新されます。

Linear 用 ODBC ドライバ のプロファイルを作成

以下の手順に従って、Database Painter ツールを使用し、Linear の ODBC DSN（データソース名）に基づいてデータベースプロファイルを作成します。Database Painter では、ウィザードや UI を使用してLinear のデータを操作できます。

1. PowerBuilder で、［ツール］ -> ［Database Painter］をクリックします。
2. Database Painter の ［オブジェクト］ ウィンドウで、ODBC ノードを右クリックし、［新しいプロファイル］ をクリックします。
3. ［接続］ タブで、プロファイル名を入力し、［データソース］ メニューで Linear DSN を選択します。
4. テーブルを表示・編集するには、テーブルを右クリックして ［データの編集］ -> ［グリッド］ をクリックします。

PowerBuilder コントロールで Linear のデータ を使用

標準の PowerBuilder オブジェクトを使用して ODBC データソースに接続し、クエリを実行できます。以下の例では、Linear のデータ を DataWindow に取得する方法を示します。次のコードを open メソッドに追加してください。

SQLCA.DBMS = "ODBC"
SQLCA.DBParm = "ConnectString='DSN=CData Linear Source'"
CONNECT USING SQLCA;
dw_team.SetTransObject(SQLCA);
dw_team.Retrieve();