CloverDX(旧CloverETL)で Pinecone のデータ に接続

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CloverDX データ統合ツールのビジュアルワークフローを使って Pinecone のデータ を転送。



CData JDBC Driver for Pinecone を使用すると、CloverDX(旧CloverETL)のデータ変換コンポーネントで Pinecone をソースとして扱えます。この記事では、JDBC Driver for Pinecone を使用して、フラットファイルへのシンプルな転送を設定する方法を説明します。

JDBC データソースとして Pinecone に接続

  1. Pinecone のデータ への接続を作成します。新規のCloverDX グラフで、Outline ペインの「Connections」ノードを右クリックし、「Connections」->「Create Connection」をクリックします。Database Connection ウィザードが表示されます。
  2. プラスアイコンをクリックし、JAR からドライバーをロードします。インストールディレクトリのlib サブフォルダを参照し、cdata.jdbc.api.jar ファイルを選択します。
  3. JDBC URL を入力します。

    認証

    Pinecone への認証では、API キー認証を使って自分のデータに接続したり、他のユーザーが各自のデータに接続できるようにしたりできます。

    API キー認証の設定

    API キーで認証するには、https://app.pinecone.io/ の Pinecone コンソールから API Key を取得します。

    取得したら、AuthScheme を APIKey に設定し、API キーを指定して接続します:

    • AuthScheme:APIKey に設定します。
    • APIKey:Pinecone の API キーに設定します。

    接続文字列の例:

    標準的な API キー設定:

    Profile=C:\profiles\Pinecone.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key;APIVersion=2025-10';
    

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

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

    java -jar cdata.jdbc.api.jar
    

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

    一般的なJDBC URL は次のようになります:

    jdbc:api:Profile=C:\profiles\Pinecone.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key;APIVersion=2025-10';

DBInputTable コンポーネントで Pinecone のデータ をクエリ

  1. Palette の「Readers」から「DBInputTable」をジョブフローにドラッグし、ダブルクリックして設定エディターを開きます。
  2. 「DB connection」プロパティで、ドロップダウンメニューから Pinecone JDBC データソースを選択します。
  3. SQL クエリを入力します。例:
    SELECT ,  FROM Indexes WHERE Name = 'my-index'

クエリの出力をUniversalDataWriter に書き込む

  1. 「Writers」から「UniversalDataWriter」をジョブフローにドラッグします。
  2. UniversalDataWriter をダブルクリックして設定エディターを開き、ファイルURL を追加します。
  3. DBInputTable を右クリックし、「Extract Metadata」をクリックします。
  4. DBInputTable の出力ポートをUniversalDataWriter に接続します。
  5. UniversalDataWriter の「Select Metadata」メニューで、Indexes テーブルを選択します。(このメニューはUniversalDataWriter の入力ポートを右クリックしても開けます。)
  6. 「Run」をクリックして、ファイルに書き込みます。

はじめる準備はできましたか?

API Driver で Pinecone のライブデータに接続

Pinecone に接続