v0.3.0

This release introduces a number of new features:

• Serverless index backup and restore job management.
• Index namespace management.
• BYOC (Bring Your Own Cloud) Indexes.
• Indexes with dedicated read nodes.
• Index metadata schema support.

Backup and restore serverless indexes

You can now backup and restore serverless indexes using the pc backup command. A backup is a static copy of a serverless index that only consumes storage. It is a non-queryable representation of a set of records. You can create a backup of a serverless index, and you can create a new serverless index from a backup. This allows you to restore the index with the same or different configurations.

# Create a backup from an existing index
pc backup create --index-name my-index --name my-index-backup --description "my index backup"

# List all backups in the current project, or filter by index
pc backup list
pc backup list --index-name my-index

# Describe a specific backup
pc backup describe --id backup-id-123

# Restore an index from a backup
pc backup restore --id backup-id-123 --name my-index-restored

# List all restore jobs for the current project
pc backup restore list

# Describe a specific restore job
pc backup restore describe --id restore-id-123

# Delete a backup
pc backup delete --id backup-id-123

Work with index namespaces

The pc index namespace command allows you to explicitly work with namespaces within an index.

# Create a namespace
pc index namespace create --index-name my-index --name ns-1

# Describe a namespace
pc index namespace describe --index-name my-index --name ns-1

# List index namespaces
pc index namespace list --index-name my-index

# Delete a namespace, including all of its data
pc index namespace delete --index-name my-index --name ns-1

Indexes with Dedicated Read Node configuration

The CLI now supports creating indexes with dedicated read node configurations. Indexes built on dedicated read nodes use provisioned read hardware to provide predictable, consistent performance at sustained, high query volumes. They’re designed for large-scale vector workloads such as semantic search, recommendation engines, and mission-critical services.

# Create a dedicated serverless index, and an on demand index
pc index create \
  --name dedicated-index \
  --dimension 1824 \
  --metric cosine \
  --region us-east-1 \
  --cloud aws \
  --read-node-type b1 \
  --read-shards 1 \
  --read-replicas 1

pc index create \
  --name on-demand-index \
  --dimension 1824 \
  --metric cosine \
  --region us-east-1 \
  --cloud aws \

# Convert a dedicated index to an on demand index
pc index configure --name dedicated-index --read-mode ondemand

# Convert an on demand index to a dedicated index
pc index configure --name on-demand-index --read-mode dedicated

BYOC Indexes

If you have gone through the process of setting up your own environment for deploying Pinecone, you can create a BYOC index using the --byoc-environment flag.

$ pc index create --name byoc-index --byoc-environment aws-us-east-1-b921 --metric cosine --dimension 1824

Serverless index metadata schema

You can now create serverless indexes with defined metadata schemas.

pc index create \
  --name on-demand-index \
  --dimension 1824 \
  --metric cosine \
  --region us-east-1 \
  --cloud aws \
  --schema genre,year,director

Changelog

• 9a4ea15 Allow attribution tags through go-pinecone (PINECONE_CLI_ATTRIBUTION_TAG) (#63)
• aeec157 Implement BYOC, DRN, and Metadata Indexing (#60)
• d091eea Implement backup command (serverless index backups / restore jobs) (#62)
• 254adb4 Implement pc index namespace command (#61)