Connect to Pinecone

Domino’s Pinecone vector database Data Source connector enables easy, secure access to vectorized content stored in Pinecone.

Create a Pinecone Data Source

You will need the following information about your Pinecone database:

Optional: Pinecone environment name
Optional: Pinecone project ID
Pinecone API key

Note	Pinecone environment name and Pinecone project ID are required if the data source is accessed through Python pinecone-client<3.0.0.

Follow these steps to find the Pinecone project ID:

Log into Pinecone and select the index you want to use:
Your project ID is the seven-character string (3r4nvmg in this example):

To create a Pinecone Data Source:
From the navigation pane, click Data > Data Sources.
Click Create a Data Source.
In the New Data Source window, from Select Data Store, select Pinecone.
Provide the Pinecone environment name, Pinecone project ID, and Pinecone API Key for your Pinecone database.
Create a Data Source Name and an optional Description.

Domino stores your Pinecone API Key, along with other secrets, in a secure secret store backed by HashiCorp Vault, so you can have confidence that your secrets are safe. You can test the API key before finalizing your Data Source:

Click Test Credentials.
Confirm that the Data Source authenticates.
Select who can view and use the Data Source in Projects.

Use the Pinecone Data Source

To use your Pinecone Data Source, you must install the prerequisite Python libraries in the compute Environment you want to run Pinecone commands in and configure the Pinecone client using a Domino-specific configuration.

Install the Pinecone Python library and Domino Data SDK

To use the Pinecone Python library in Domino, you must install the following libraries in your compute Environment. Domino standard environments have these libraries installed by default. If you are using a customized environment, Edit your compute Environment and add the following lines to the Dockerfile instructions:

Important

You must replace the placeholder {x.y.z} with the compatible version of your Domino deployment. Refer to all released packages.

USER root

RUN python -m pip install pinecone-client

RUN python -m pip install dominodatalab-data=={x.y.z}

USER ubuntu

Configure the Pinecone Python client

To connect to your Pinecone service in a Domino execution, you must initialize your Pinecone connection using a Domino-specific Environment. To find the configuration code snippets:

Add the Pinecone Data Source to your Project.
In your Workspace, go to Data > Data Sources > Code snippet > Python.

Copy the code snippet, paste it into your code, and modify it as needed.

The code snippet for pinecone-client<3.0.0:

import os
import pinecone
from domino_data.vectordb import DominoPineconeConfiguration

datasource_name = "pinecone"
conf = DominoPineconeConfiguration(datasource=datasource_name)
# The pinecone API key should be provided when creating the Domino Data Source and persisted securely.
# This api_key variable is only used to satisfy the native Pinecone Python client initialization where
# api_key is a mandatory non-empty field.
api_key = os.environ.get("DOMINO_VECTOR_DB_METADATA", datasource_name)

pinecone.init(
    api_key=api_key,
    environment="domino",
    openapi_config=conf)

print(pinecone.list_indexes())

# Replace the place holder {{index_name}} below with the index name.
index = pinecone.Index("{{index_name}}")
index.describe_index_stats()

The code snippet for pinecone-client>=3.0.0:

from domino_data.vectordb import domino_pinecone3x_init_params, domino_pinecone3x_index_params
from pinecone import Pinecone

datasource_name = "pinecone"
pc = Pinecone(**domino_pinecone3x_init_params(datasource_name))
print(pc.list_indexes())

# Replace the place holder {{index_name}} below with the index name.
index_name = "{{index_name}}"
index = pc.Index(**domino_pinecone3x_index_params(datasource_name, index_name))
print(index.describe_index_stats())

# More Pinecone Python library-supported operations can be found at https://docs.pinecone.io/docs/python-client
# gRPC client is currently not supported.

Once your Pinecone connection is initialized in the Domino execution, you can use the Pinecone Python client as usual.

Next steps

Share this Data Source with your collaborators.