{"id":23267,"library":"apache-airflow-providers-pinecone","title":"Apache Airflow Provider for Pinecone","description":"Apache Airflow provider for integrating with Pinecone vector database. Version 2.4.4 supports Airflow 2.x and Python >=3.10. Provides hooks and operators to manage Pinecone indexes, upsert vectors, and run queries. Release cadence follows Airflow's provider releases.","status":"active","version":"2.4.4","language":"python","source_language":"en","source_url":"https://github.com/apache/airflow/tree/main/airflow/providers/pinecone","tags":["airflow","pinecone","vector-database","provider"],"install":[{"cmd":"pip install apache-airflow-providers-pinecone","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required runtime dependency","package":"apache-airflow","optional":false},{"reason":"Official Pinecone Python client","package":"pinecone-client","optional":false}],"imports":[{"note":"Incorrect parent module; PineconeHook is in hooks.pinecone, not directly in hooks","wrong":"from airflow.providers.pinecone.hooks import PineconeHook","symbol":"PineconeHook","correct":"from airflow.providers.pinecone.hooks.pinecone import PineconeHook"},{"note":"Operator is in the pinecone submodule, not directly in operators","wrong":"from airflow.providers.pinecone.operators import PineconeIngestOperator","symbol":"PineconeIngestOperator","correct":"from airflow.providers.pinecone.operators.pinecone import PineconeIngestOperator"}],"quickstart":{"code":"from airflow.providers.pinecone.hooks.pinecone import PineconeHook\nhook = PineconeHook(pinecone_conn_id='pinecone_default')\nhook.create_index(name='test-index', dimension=512, metric='cosine')","lang":"python","description":"Initialize a PineconeHook and create an index. Ensure a Pinecone connection is defined in Airflow."},"warnings":[{"fix":"Create an Airflow connection with type 'Pinecone' containing the API key and environment, then pass the connection ID.","message":"In version 2.4.0, the hook signature changed: `PineconeHook` now requires `pinecone_conn_id` instead of `api_key` and `environment`. Old connections using raw keys will break.","severity":"breaking","affected_versions":">=2.4.0"},{"fix":"Ensure your data is a list of dicts: [{'id': 'vec1', 'values': [0.1, 0.2, ...]}, ...].","message":"The operator `PineconeIngestOperator` expects input as a list of dictionaries with keys 'id' and 'values', not raw tuples or pandas DataFrames. Converting non-standard formats is the user's responsibility.","severity":"gotcha","affected_versions":"all"},{"fix":"Replace calls to `hook.describe_index_stats(index_name)` with `hook.describe_index(index_name)`.","message":"The method `describe_index_stats` on `PineconeHook` was deprecated in 2.4.3 in favor of `describe_index` which returns full metadata including dimension and metric.","severity":"deprecated","affected_versions":"2.4.3+"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install the provider: pip install apache-airflow-providers-pinecone. Ensure you are using Airflow 2.0+.","cause":"Provider package not installed or Airflow is too old (<2.0) and doesn't support providers.","error":"ModuleNotFoundError: No module named 'airflow.providers.pinecone'"},{"fix":"Upgrade to the latest provider: pip install --upgrade apache-airflow-providers-pinecone","cause":"Using an older version of the provider (<2.4.0) where create_index was not exposed.","error":"AttributeError: 'PineconeHook' object has no attribute 'create_index'"},{"fix":"In Airflow UI, edit the Pinecone connection to include the correct environment, ensure API key is set, and check network/firewall settings.","cause":"Missing or incorrect Pinecone environment in connection. The environment must match your Pinecone project (e.g., 'us-west1-gcp').","error":"Connection to Pinecone failed: SSL error"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}