Skip to main content
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: To create a Pinecone Data Source:
  1. From the navigation pane, click Data > Data Sources.
  2. Click Create a Data Source.
  3. In the New Data Source window, from Select Data Store, select Pinecone.
  4. Provide the Pinecone API Key for your Pinecone database.
  5. 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:
  1. Click Test Credentials.
  2. Confirm that the Data Source authenticates.
  3. 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:
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:
  1. Add the Pinecone Data Source to your Project.
  2. In your Workspace, go to Data > Data Sources > Code snippet > Python.
  3. Copy the code snippet, paste it into your code, and modify it as needed.
Domino now only supports accessing the Pinecone data source through Python pinecone-client>=3.0.0.
  • 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