oracle-vecdb 1.0.0__tar.gz

oracle_vecdb-1.0.0/CHANGELOG.rst

@@ -0,0 +1,54 @@
+Changelog
+=========
+
+All notable changes to this project will be documented in this file.
+
+The format is based on the `Keep a Changelog <https://keepachangelog.com/en/1.1.0/>`__,
+and this project adheres to `Semantic Versioning <https://semver.org/spec/v2.0.0.html>`__.
+
+1.0.0 - 2026-07-15
+------------------
+
+Added
+~~~~~
+
+- Initial public release of oracle_vecdb
+- Support for vector table management, indexing, search, and inference operations in Oracle AI Database (26ai+). Refer this for detailed documentation -
+ https://docs.oracle.com/en/cloud/paas/autonomous-vector-database/vcapi/overview.html
+
+
+1.0.0b2 - 2026-04-30
+------------------
+
+Added
+~~~~~
+
+- Added support for automatic batching during large dataset upsert.
+- Added support for case-insensitive input keys, allowing user data to use any capitalization for ID, DENSE_VECTOR, and METADATA.
+- Updated the host URL validation pattern to work in ExaCC environments for pool mappings.
+- Added "rest_url" as the preferred parameter and deprecated "host", with support for disabling "host" later via a feature toggle.
+
+Changed
+~~~~~~~
+
+- Renamed `agent.md` to `AGENTS.md` and streamlined it around verified public SDK workflows.
+
+Fixed
+~~~~~
+
+- Fixed the ``rerank`` API reference to mention results from ``query`` instead of ``query_vectors()``.
+
+1.0.0b1 - 2026-03-24
+------------------
+
+Added
+~~~~~
+
+- Limited Availability release.
+- Support for vector table management, indexing, search, and inference operations in Oracle AI Database (26ai+).
+
+
+Compatibility
+----------
+Requires - Oracle AI Database 23.26.3 and later with ORDS 26.2.2 and later
+Supported languages: Python 3.10+

oracle_vecdb-1.0.0/LICENSE.txt

@@ -0,0 +1,35 @@
+Copyright (c) 2026 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

oracle_vecdb-1.0.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include LICENSE.txt README.md CHANGELOG.rst pyproject.toml
+recursive-include examples *.py

oracle_vecdb-1.0.0/PKG-INFO

@@ -0,0 +1,282 @@
+Metadata-Version: 2.4
+Name: oracle-vecdb
+Version: 1.0.0
+Summary: Oracle VecDB Python SDK
+Author: Oracle
+License-Expression: UPL-1.0
+Project-URL: Repository, https://github.com/oracle/vecdb-python-sdk
+Project-URL: Homepage, https://docs.oracle.com/en-us/iaas/tools/vecdb/latest/index.html
+Keywords: Oracle,vecdb,vector,database,ords,sdk
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Database :: Database Engines/Servers
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2
+Requires-Dist: typing-extensions>=4.7.1
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
+Requires-Dist: types-python-dateutil; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: tox; extra == "dev"
+Requires-Dist: oci-cli; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: pytest-mock; extra == "test"
+Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: lxml; extra == "test"
+Provides-Extra: doc
+Requires-Dist: sphinx; extra == "doc"
+Requires-Dist: sphinx_autodoc_typehints; extra == "doc"
+Requires-Dist: sphinx-rtd-theme; extra == "doc"
+Dynamic: license-file
+
+# Oracle VecDB Python SDK &nbsp;⚡️
+
+<p align="center">
+  <img src="https://img.shields.io/pypi/v/oracle-vecdb?color=%23f80000&label=PyPI&logo=python" alt="PyPI">
+  <img src="https://img.shields.io/pypi/pyversions/oracle-vecdb.svg?logo=python&label=Python" alt="Python Versions">
+  <img src="https://img.shields.io/badge/status-active-success?style=flat" alt="Status">
+</p>
+
+## 🚀 About
+
+Oracle VecDB Python SDK is the Python client for the Oracle AI Database (26ai+). It covers both Autonomous AI Vector Database deployments and customer-managed Oracle AI Database instances where ORDS is enabled, offering simple APIs for vector table management, indexing, search, and inference operations.
+
+
+## ✨ Highlights
+
+- 🔐 Typed client with simple auth + configuration
+- 📦 Manage vector tables, vector indexes, and metadata programmatically
+- 🧠 Run embeddings & inference flows via Oracle AI Database models
+- 🔄 Integrate vector search, filtering, and RAG-style pipelines quickly
+
+
+## 📦 Installation
+
+```bash
+pip install oracle-vecdb
+```
+
+**Requires:** Python 3.10+
+
+
+## 🚀 Quickstart
+
+```python
+from oracle_vecdb import OracleVecDB, Configuration
+
+config = Configuration(
+    rest_url="https://<host>:<port>/ords/<schema>/_/db-api/stable/vecdb/",
+    # choose one auth method
+    access_token="<bearer-token>",
+    # or username="<user>", password="<pass>",
+)
+
+vecdb = OracleVecDB(config)
+
+vecdb.create_vector_table(
+    name="demo",
+    table_params={"auto_generate_id": True},
+    embed_params={
+        "model": "all_MiniLM_L12_v2",  # must be preloaded via Vector Database Console or load_model()
+        "embed_metadata_jsonpath": "content",  # JSON field in metadata to extract text from for embedding
+    },
+)
+
+vecdb.upsert_vectors(
+    table_name="demo",
+    vectors=[
+        {
+            "metadata": {
+                "title": "Comedy movie review",
+                "content": "A lighthearted comedy with fast-paced jokes.",  # text to embed
+                "genre": "comedy",
+            }
+        },
+        {
+            "metadata": {
+                "title": "Drama movie review",
+                "content": "An emotional family drama with strong performances.",
+                "genre": "drama",
+            }
+        },
+    ],
+)
+
+results = vecdb.query(
+    table_name="demo",
+    query_by={"text": "family drama"},  # uses integrated embeddings for the query text
+    filters={"genre": {"$eq": "drama"}},
+    top_k=1,
+)
+
+for index in range(len(results)):
+    item = results[index]
+    row = item if isinstance(item, dict) else item.model_dump()
+    print(row["id"], row["distance"], row["metadata"])
+```
+
+### 📥 Ingestion Options
+
+#### Bring your own vectors
+
+```python
+vecdb.create_vector_table(name="demo")
+# Large inline datasets >32MB are automatically split into bounded requests.
+# Batching preserves order but does not deduplicate IDs or guarantee avoidance
+# of service rate limits.
+response = vecdb.upsert_vectors(
+    table_name="demo",
+    vectors=[
+        {"id": "1", "dense_vector": [0.1, 0.1], "metadata": {"genre": "comedy"}},
+        {"id": "2", "dense_vector": [0.2, 0.2], "metadata": {"genre": "drama"}},
+    ],
+)
+print(response.upserted_count)
+```
+
+For huge dataset, prefer asynchronous bulk loading from object
+storage instead of sending a large inline JSON request. This avoids keeping
+the complete dataset in the request body and is better suited to production
+ingestion workloads:
+
+```python
+load_job = vecdb.load_vectors(
+    table_name="demo",
+    url="https://objectstorage.<region>.oraclecloud.com/<namespace>/<bucket>/vectors.csv",
+    params={"credential": "<oci-credential-name>"},
+)
+
+status = vecdb.describe_vector_load_job(load_job.job_name)
+print(status.state)
+```
+
+The CSV should contain `id`, `dense_vector`, and `metadata` columns. Use an
+OCI credential configured for the database when the object is not publicly
+readable. Do not place signed URLs or credentials directly in application
+logs. `upsert_vectors` remains useful for small inline batches and is
+automatically split below the service JSON limit, but it does not replace
+bulk loading for large files.
+
+```python
+results = vecdb.query(
+    table_name="demo",
+    query_by={"vector": [0.15, 0.1]},
+    filters={"genre": {"$eq": "drama"}},
+    top_k=1,
+)
+
+for index in range(len(results)):
+    item = results[index]
+    row = item if isinstance(item, dict) else item.model_dump()
+    print(row["metadata"]["genre"])
+
+# Collection endpoints support ORDS pagination. Existing calls without these
+# arguments retain the server's default page size.
+tables_page = vecdb.list_vector_tables(limit=25, offset=25)
+models_page = vecdb.list_models(limit=25, offset=0)
+```
+
+### 🔧 Indexing & tuning
+
+Delay index creation until `create_index()`
+
+```python
+vecdb.create_vector_table(
+    name="demo_byuser",
+    index_params={
+        "vector_index_params": {
+            "auto_index": False,
+        }
+    },
+)
+
+vecdb.create_index(
+    table_name="demo_byuser",
+)
+```
+
+Create HNSW index instead of default IVF
+
+```python
+vecdb.create_vector_table(
+    name="demo_hnsw",
+    index_params={
+        "vector_index_params": {
+            "auto_index": True,
+            "organization": "INMEMORY GRAPH",  # HNSW-style index organization
+            "distance_metric": "COSINE",
+            "advanced_params": {
+                "neighbors": 32,  # higher = better recall, more memory
+                "efConstruction": 200,  # higher = better recall, slower index build
+            },
+        },
+    },
+)
+```
+
+Query-time HNSW tuning
+
+```python
+results = vecdb.query(
+    table_name="demo",
+    query_by={"text": "family drama"},
+    filters={"genre": {"$eq": "drama"}},
+    top_k=1,
+    advanced_options={
+        "idx_parameters": {
+            "efsearch": 64,  # number of candidates explored (higher = better recall, higher latency)
+        }
+    },
+)
+```
+
+
+## 🧪 Sample notebooks & apps
+
+- [Sample notebooks](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/notebooks/vecdb) – Guided notebooks for setup, table/index workflows, vector search, and inference via the SDK.
+- [Sample applications](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/vecdb) – Oracle AI Developer Hub apps showcasing ingestion, embeddings, search, filtering, and FastAPI + React/Vite integration using this SDK.
+
+## 📚 Documentation & Resources
+
+Most SDK methods return typed response models. Import stable SDK response types
+from `oracle_vecdb.data_types`, and use `.model_dump()` or `.to_dict()` when
+you need a plain dictionary representation.
+
+- [Autonomous AI Vector Database docs](https://docs.oracle.com/en/cloud/paas/autonomous-vector-database)
+- [Autonomous AI Vector Database setup guide](https://docs.oracle.com/en/cloud/paas/autonomous-vector-database/vecdb/get-started-using-autonomous-ai-vector-database.html)
+- [Customer-managed Oracle AI Database (26ai+) requirements](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/26.2/) – DB 23.26.3+ with ORDS 26.2.2+, plus TLS/ORDS notes for handling self-signed certificates
+- [Quickstart guide](./docs/source/quickstart.rst)
+- [Installation notes](./docs/source/installation.rst)
+- [API reference](https://docs.oracle.com/en/cloud/paas/autonomous-vector-database/vcapi/index.html)
+- [Changelog](./CHANGELOG.rst)
+- [Examples](./examples/test_client.py)
+
+
+
+## 🤝 Contributing
+
+This project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md)
+
+## 🔐 Security
+
+Please consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process
+
+## 📄 License
+
+See [LICENSE.txt](./LICENSE.txt), [THIRD_PARTY_LICENSE.txt](./THIRD_PARTY_LICENSE.txt), and [NOTICE.txt](./NOTICE.txt).

oracle_vecdb-1.0.0/README.md

@@ -0,0 +1,235 @@
+# Oracle VecDB Python SDK  ⚡️
+
+<p align="center">
+  <img src="https://img.shields.io/pypi/v/oracle-vecdb?color=%23f80000&label=PyPI&logo=python" alt="PyPI">
+  <img src="https://img.shields.io/pypi/pyversions/oracle-vecdb.svg?logo=python&label=Python" alt="Python Versions">
+  <img src="https://img.shields.io/badge/status-active-success?style=flat" alt="Status">
+</p>
+
+## 🚀 About
+
+Oracle VecDB Python SDK is the Python client for the Oracle AI Database (26ai+). It covers both Autonomous AI Vector Database deployments and customer-managed Oracle AI Database instances where ORDS is enabled, offering simple APIs for vector table management, indexing, search, and inference operations.
+
+
+## ✨ Highlights
+
+- 🔐 Typed client with simple auth + configuration
+- 📦 Manage vector tables, vector indexes, and metadata programmatically
+- 🧠 Run embeddings & inference flows via Oracle AI Database models
+- 🔄 Integrate vector search, filtering, and RAG-style pipelines quickly
+
+
+## 📦 Installation
+
+```bash
+pip install oracle-vecdb
+```
+
+**Requires:** Python 3.10+
+
+
+## 🚀 Quickstart
+
+```python
+from oracle_vecdb import OracleVecDB, Configuration
+
+config = Configuration(
+    rest_url="https://<host>:<port>/ords/<schema>/_/db-api/stable/vecdb/",
+    # choose one auth method
+    access_token="<bearer-token>",
+    # or username="<user>", password="<pass>",
+)
+
+vecdb = OracleVecDB(config)
+
+vecdb.create_vector_table(
+    name="demo",
+    table_params={"auto_generate_id": True},
+    embed_params={
+        "model": "all_MiniLM_L12_v2",  # must be preloaded via Vector Database Console or load_model()
+        "embed_metadata_jsonpath": "content",  # JSON field in metadata to extract text from for embedding
+    },
+)
+
+vecdb.upsert_vectors(
+    table_name="demo",
+    vectors=[
+        {
+            "metadata": {
+                "title": "Comedy movie review",
+                "content": "A lighthearted comedy with fast-paced jokes.",  # text to embed
+                "genre": "comedy",
+            }
+        },
+        {
+            "metadata": {
+                "title": "Drama movie review",
+                "content": "An emotional family drama with strong performances.",
+                "genre": "drama",
+            }
+        },
+    ],
+)
+
+results = vecdb.query(
+    table_name="demo",
+    query_by={"text": "family drama"},  # uses integrated embeddings for the query text
+    filters={"genre": {"$eq": "drama"}},
+    top_k=1,
+)
+
+for index in range(len(results)):
+    item = results[index]
+    row = item if isinstance(item, dict) else item.model_dump()
+    print(row["id"], row["distance"], row["metadata"])
+```
+
+### 📥 Ingestion Options
+
+#### Bring your own vectors
+
+```python
+vecdb.create_vector_table(name="demo")
+# Large inline datasets >32MB are automatically split into bounded requests.
+# Batching preserves order but does not deduplicate IDs or guarantee avoidance
+# of service rate limits.
+response = vecdb.upsert_vectors(
+    table_name="demo",
+    vectors=[
+        {"id": "1", "dense_vector": [0.1, 0.1], "metadata": {"genre": "comedy"}},
+        {"id": "2", "dense_vector": [0.2, 0.2], "metadata": {"genre": "drama"}},
+    ],
+)
+print(response.upserted_count)
+```
+
+For huge dataset, prefer asynchronous bulk loading from object
+storage instead of sending a large inline JSON request. This avoids keeping
+the complete dataset in the request body and is better suited to production
+ingestion workloads:
+
+```python
+load_job = vecdb.load_vectors(
+    table_name="demo",
+    url="https://objectstorage.<region>.oraclecloud.com/<namespace>/<bucket>/vectors.csv",
+    params={"credential": "<oci-credential-name>"},
+)
+
+status = vecdb.describe_vector_load_job(load_job.job_name)
+print(status.state)
+```
+
+The CSV should contain `id`, `dense_vector`, and `metadata` columns. Use an
+OCI credential configured for the database when the object is not publicly
+readable. Do not place signed URLs or credentials directly in application
+logs. `upsert_vectors` remains useful for small inline batches and is
+automatically split below the service JSON limit, but it does not replace
+bulk loading for large files.
+
+```python
+results = vecdb.query(
+    table_name="demo",
+    query_by={"vector": [0.15, 0.1]},
+    filters={"genre": {"$eq": "drama"}},
+    top_k=1,
+)
+
+for index in range(len(results)):
+    item = results[index]
+    row = item if isinstance(item, dict) else item.model_dump()
+    print(row["metadata"]["genre"])
+
+# Collection endpoints support ORDS pagination. Existing calls without these
+# arguments retain the server's default page size.
+tables_page = vecdb.list_vector_tables(limit=25, offset=25)
+models_page = vecdb.list_models(limit=25, offset=0)
+```
+
+### 🔧 Indexing & tuning
+
+Delay index creation until `create_index()`
+
+```python
+vecdb.create_vector_table(
+    name="demo_byuser",
+    index_params={
+        "vector_index_params": {
+            "auto_index": False,
+        }
+    },
+)
+
+vecdb.create_index(
+    table_name="demo_byuser",
+)
+```
+
+Create HNSW index instead of default IVF
+
+```python
+vecdb.create_vector_table(
+    name="demo_hnsw",
+    index_params={
+        "vector_index_params": {
+            "auto_index": True,
+            "organization": "INMEMORY GRAPH",  # HNSW-style index organization
+            "distance_metric": "COSINE",
+            "advanced_params": {
+                "neighbors": 32,  # higher = better recall, more memory
+                "efConstruction": 200,  # higher = better recall, slower index build
+            },
+        },
+    },
+)
+```
+
+Query-time HNSW tuning
+
+```python
+results = vecdb.query(
+    table_name="demo",
+    query_by={"text": "family drama"},
+    filters={"genre": {"$eq": "drama"}},
+    top_k=1,
+    advanced_options={
+        "idx_parameters": {
+            "efsearch": 64,  # number of candidates explored (higher = better recall, higher latency)
+        }
+    },
+)
+```
+
+
+## 🧪 Sample notebooks & apps
+
+- [Sample notebooks](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/notebooks/vecdb) – Guided notebooks for setup, table/index workflows, vector search, and inference via the SDK.
+- [Sample applications](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/vecdb) – Oracle AI Developer Hub apps showcasing ingestion, embeddings, search, filtering, and FastAPI + React/Vite integration using this SDK.
+
+## 📚 Documentation & Resources
+
+Most SDK methods return typed response models. Import stable SDK response types
+from `oracle_vecdb.data_types`, and use `.model_dump()` or `.to_dict()` when
+you need a plain dictionary representation.
+
+- [Autonomous AI Vector Database docs](https://docs.oracle.com/en/cloud/paas/autonomous-vector-database)
+- [Autonomous AI Vector Database setup guide](https://docs.oracle.com/en/cloud/paas/autonomous-vector-database/vecdb/get-started-using-autonomous-ai-vector-database.html)
+- [Customer-managed Oracle AI Database (26ai+) requirements](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/26.2/) – DB 23.26.3+ with ORDS 26.2.2+, plus TLS/ORDS notes for handling self-signed certificates
+- [Quickstart guide](./docs/source/quickstart.rst)
+- [Installation notes](./docs/source/installation.rst)
+- [API reference](https://docs.oracle.com/en/cloud/paas/autonomous-vector-database/vcapi/index.html)
+- [Changelog](./CHANGELOG.rst)
+- [Examples](./examples/test_client.py)
+
+
+
+## 🤝 Contributing
+
+This project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md)
+
+## 🔐 Security
+
+Please consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process
+
+## 📄 License
+
+See [LICENSE.txt](./LICENSE.txt), [THIRD_PARTY_LICENSE.txt](./THIRD_PARTY_LICENSE.txt), and [NOTICE.txt](./NOTICE.txt).

oracle_vecdb-1.0.0/examples/test_client.py

@@ -0,0 +1,71 @@
+##
+## Copyright (c) 2026 Oracle and/or its affiliates.
+## Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
+##
+
+import os
+from oracle_vecdb import OracleVecDB, Configuration
+
+
+def main():
+    # Use a valid HTTPS ORDS VecDB endpoint. Example pattern:
+    # https://<host>:<port>/ords/<schema>/_/db-api/stable/vecdb/
+    config = Configuration(
+        rest_url="https://example.com/ords/foo/_/db-api/stable/vecdb/",
+        username="username",
+        password=os.getenv("DB_PASSWORD"),
+    )
+
+    vecdb = OracleVecDB(config)
+
+    try:
+        vecdb.create_vector_table(name="TEST_DB")
+        vecdb.upsert_vectors(
+            table_name="TEST_DB",
+            vectors=[
+                {
+                    "id": "A",
+                    "dense_vector": [0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1],
+                    "metadata": {"genre": "comedy", "year": 2020},
+                },
+                {
+                    "id": "B",
+                    "dense_vector": [0.2, 0.2, 0.2, 0.2, 0.2, 0.2, 0.2, 0.2],
+                    "metadata": {"genre": "documentary", "year": 2019},
+                },
+                {
+                    "id": "C",
+                    "dense_vector": [0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3],
+                    "metadata": {"genre": "comedy", "year": 2019},
+                },
+                {
+                    "id": "D",
+                    "dense_vector": [0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4],
+                    "metadata": {"genre": "drama"},
+                },
+            ],
+        )
+        result = vecdb.query(
+            table_name="TEST_DB",
+            query_by={
+                "vector": [
+                    -0.00337490835,
+                    0.0575999133,
+                    -0.0147442026,
+                    -0.0645009279,
+                    0.0645009279,
+                    0.0645009279,
+                    0.0645009279,
+                    0.0645009279,
+                ]
+            },
+            top_k=2,
+        )
+
+        print(result)
+    except Exception as exc:
+        print("An error occurred:", exc)
+
+
+if __name__ == "__main__":
+    main()