Pinecone Vector Database

Overview

The component is based on the REST Pinecone API client which allows you to create / update / delete indexes and vectors.

At a glance

Features

• Native Delphi implementation with full ANSI/Unicode support.

Technical specification

Main properties

The principal published / public properties used to configure and drive the component. Consult the online help for the full list.

Main methods

The principal public methods exposed by the component.

Quick Start

Drop the component on a form, configure the properties below and activate it. The snippet that follows shows the typical Example UPSERT configuration sourced from the online help.

Delphi (VCL / FireMonkey)

procedure UpsertPinecone(const aIndexName, aProjectId: string; const aVector: Array of Double);
var
  oPinecone: TsgcHTTP_API_Pinecone;
  oParams: TsgcHTTPPineconeVectorUpserts;
  oVectors: TsgcArrayOfVectorUpsert;
begin
  oPinecone := TsgcHTTP_API_Pinecone.Create(nil);
  Try
    oPinecone.PineconeOptions.API := 'your-api-key';
    oParams := TsgcHTTPPineconeVectorUpserts.Create;
    Try
      SetLength(oVectors, 1);
      oVectors[0] := TsgcHTTPPineconeVectorUpsert.Create;
      oVectors[0].Id := 'id1';
      oVectors[0].Values := aVector;
      oParams.Vectors := oVectors;
      Pinecone.VectorsUpsert(aIndexName, aProjectId, oParams);
    Finally
      oParams.Free;
    End;
  Finally
    oPinecone.Free;
  End;
end;

C++ Builder

void UpsertPinecone(const String aIndexName, const String aProjectId, const std::vector<double> aVector)
{
  TsgcHTTP_API_Pinecone* oPinecone = new TsgcHTTP_API_Pinecone(NULL);
  try
  {
    oPinecone->PineconeOptions.API = "your-api-key";
    TsgcHTTPPineconeVectorUpserts* oParams = new TsgcHTTPPineconeVectorUpserts();
    try
    {
      TsgcArrayOfVectorUpsert oVectors;
      oVectors.push_back(new TsgcHTTPPineconeVectorUpsert());
      oVectors[0]->Id = "id1";
      oVectors[0]->Values = aVector;
      oParams->Vectors = oVectors;
      oPinecone->VectorsUpsert(aIndexName, aProjectId, oParams);
    }
    __finally
    {
      oParams->Free();
    }
  }
  __finally
  {
    oPinecone->Free();
  }
}

.NET (C#)

void UpsertPinecone(string aIndexName, string aProjectId, double[] aVector)
{
    TsgcHTTP_API_Pinecone oPinecone = new TsgcHTTP_API_Pinecone(null);
    oPinecone.PineconeOptions.API = "your-api-key";
    TsgcHTTPPineconeVectorUpserts oParams = new TsgcHTTPPineconeVectorUpserts();
    TsgcArrayOfVectorUpsert oVectors = new TsgcArrayOfVectorUpsert();
    oVectors.Add(new TsgcHTTPPineconeVectorUpsert()
    {
        Id = "id1",
        Values = aVector
    });
    oParams.Vectors = oVectors;
    oPinecone.VectorsUpsert(aIndexName, aProjectId, oParams);
}

Common scenarios

The following scenarios are lifted verbatim from the online help. Each shows the configuration and method calls needed to drive the component through a specific real-world flow.

1 · Example QUERY

Find below an example of QUERY a single vector.

procedure QueryPinecone(const aIndexName, aProjectId: string; const aVector: Array of Double);
var
  oParams: TsgcHTTPPineconeVectorQuery;
begin
  oParams := TsgcHTTPPineconeVectorQuery.Create;
  Try
    oParams.Vector := aVector;
    Pinecone.VectorsQuery(aIndexName, aProjectId, oParams);
  Finally
    oParams.Free;
  End;
end;

void QueryPinecone(const string aIndexName, const string aProjectId, const std::vector<double>& aVector)
{
  TsgcHTTPPineconeVectorQuery* oParams = new TsgcHTTPPineconeVectorQuery();
  try
  {
    oParams->Vector = aVector;
    Pinecone.VectorsQuery(aIndexName, aProjectId, oParams);
  }
  __finally
  {
    oParams->Free();
  }
}

void QueryPinecone(string aIndexName, string aProjectId, double[] aVector)
{
    TsgcHTTPPineconeVectorQuery oParams = new TsgcHTTPPineconeVectorQuery();
    oParams.Vector = aVector;
    
    Pinecone.VectorsQuery(aIndexName, aProjectId, oParams);
}

Sources used to build this document

Every external claim links back to a primary source. The online-help references decode the canonical deep-link the company maintains for this component.