Aqua Data Studio で Webflow のデータ に接続

CData JDBC Driver for Webflow は、Aqua Data Studio などの IDE のウィザードや分析機能と Webflow のデータ を連携できます。本記事では、接続マネージャーを使って Webflow のデータ に接続し、クエリを実行する方法を説明します。

JDBC データソースの作成

接続マネージャーを使用して接続プロパティを定義し、新しい JDBC データソースとして保存できます。作成した Webflow データソースは、Aqua Data Studio の各ツールからアクセスできるようになります。

1. Aqua Data Studio で、Servers メニューから Register Server を選択します。
2. Register Server フォームで、「Generic - JDBC」接続を選択します。
3. 以下の JDBC 接続プロパティを入力します：
   • Name: データソースの名前を入力します（例：Webflow）。
   • Driver Location: Browse ボタンをクリックし、インストールディレクトリの lib サブフォルダにある cdata.jdbc.api.jar ファイルを選択します。
   • Driver: ドライバーのクラス名 cdata.jdbc.api.APIDriver を入力します。

   • URL: JDBC URL を入力します。URL は jdbc:api: から始まり、その後にセミコロン区切りで接続プロパティを指定します。

     認証

     Webflow は、サイト、CMS コレクション、e コマースデータ、その他のリソースへの安全なアクセスを確保するために、OAuth 2.0 認証を使用します。この認証方式により、Webflow ワークスペースに安全に接続し、適切な認可のもとでリソースを管理できます。

     OAuth 2.0 のセットアップと設定

     ステップ 1：Webflow OAuth アプリケーションの作成

     OAuth 認証をセットアップするには、以下のステップで進めます：

     1. Webflow Developer Portal にアクセスします
     2. Webflow アカウントの「Apps & Integrations」に移動します
     3. 「Register an App」をクリックして新しい OAuth アプリケーションを作成します
     4. アプリケーション名、説明、リダイレクト URI（CallbackURL）を設定します
     5. 接続で使用する Client ID と Client Secret をコピーします

     必須の接続プロパティ

     • AuthScheme：OAuth に設定します（必須）
     • OAuthClientId：Webflow OAuth アプリケーションの Client ID（必須）
     • OAuthClientSecret：Webflow OAuth アプリケーションの Client Secret（必須）
     • CallbackURL：OAuth アプリケーションで指定したリダイレクト URI（必須）
     • InitiateOAuth：トークンを自動管理するには GETANDREFRESH に設定します（推奨）

     必須の OAuth スコープ

     Webflow API プロファイルでは、以下の OAuth スコープが必要です：

     • sites:read - サイト情報および設定への読み取りアクセス
     • pages:read - サイトページへの読み取りアクセス
     • cms:read - CMS コレクションおよびアイテムへの読み取りアクセス
     • forms:read - フォームおよびフォーム送信への読み取りアクセス
     • assets:read - メディアアセットおよびフォルダーへの読み取りアクセス
     • ecommerce:read - 製品、注文、在庫への読み取りアクセス
     • authorized_user:read - 認可されたユーザーへの読み取りアクセス

     組み込みの接続文字列デザイナー

     JDBC URL の作成には、Webflow JDBC Driver に組み込まれている接続文字列デザイナーをご利用いただけます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

     java -jar cdata.jdbc.api.jar
     

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     一般的な JDBC URL は以下のとおりです：

     jdbc:api:Profile=C:\profiles\Webflow.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;

   

Webflow のデータ へのクエリ

これで、公開されているテーブルにクエリを実行できます。