RazorSQL で Asana のデータ に接続
CData JDBC Driver for Asana は、IDE のウィザードからデータ管理・分析ツールまで、サードパーティツールからの標準ベースのアクセスを可能にします。この記事では、RazorSQL のウィザードを使用して Asana に接続する方法を説明します。
Asana のデータ 用の JDBC データソースを作成
- RazorSQL アプリケーションを開き、「Connections」メニューから「Add Connection Profile」->「Other」->「JDBC」を選択します。
- 表示される「Connection Wizard」で、以下のプロパティを設定します。
- Driver Location:インストールディレクトリ内の lib サブフォルダへのパスを設定します。
- Driver Class:ドライバークラスを cdata.jdbc.asana.AsanaDriver に設定します。
- Username:ユーザー名を入力します(このプロパティは JDBC URL 内でも設定できます)。
- Password:パスワードを入力します(このプロパティは JDBC URL 内でも設定できます)。
JDBC URL:接続パラメータを入力します。JDBC URL は jdbc:asana: で始まり、その後にセミコロンで区切られた接続プロパティが続きます。
Asana への接続は以下のように行います。
- WorkspaceId: Asana Wrokspace のglobally unique identifier (gid) を設定すると指定されたWorkspace のプロジェクトだけを返します。Workspace Id はhttps://app.asana.com/api/1.0/workspaces から取得します。表示されるJSON にWorkspace name およびId が含まれます。
- ProjectId: Asana Project のglobally unique identifier (gid) に設定すると指定されたProject のデータだけを返します。Project ID はプロジェクトのOverview ページのURL を参照してください。/0/ の後ろの数字 です。
Asana への認証
Asana はOAuth またはOAuthPKCE 認証標準を利用しています。認証方法については、ヘルプドキュメントの「はじめに」を参照してください。
ビルトイン接続文字列デザイナー
JDBC URL の構築には、Asana JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから jar ファイルを実行します。
java -jar cdata.jdbc.asana.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
一般的な JDBC URL は以下のとおりです。
jdbc:asana:OAuthClientId=YourClientId;OAuthClientSecret=YourClientSecret;CallbackURL='http://localhost:33333';
Asana のデータ のクエリとテーブルの選択
接続が確立されると、ウィザードが閉じ、接続パネルで接続が利用可能になります。その後、テーブルをクエリできます。