本页面为机器翻译。阅读英文原文。

Component

core/datastore/pgvector

A vector database on the PostgreSQL engine: PostgreSQL with the pgvector extension, which adds a vector column type, distance operators and approximate nearest-neighbour indexes, so embeddings are stored beside ordinary rows and queried by similarity in SQL. The server runs the pgvector project's own image, which carries the extension, and the database the component creates has it enabled. Wire here when an application retrieves by similarity and keeps its vectors in PostgreSQL; core/datastore/postgres is the general-purpose relational store, and core/datastore/qdrant, core/datastore/weaviate and core/datastore/chroma are vector stores with APIs of their own. It presents the standard PostgreSQL wire contract (POSTGRES_USER / POSTGRES_PASSWORD / POSTGRES_DB) and exports its host, port, user, database and protocol, and an endpoint joining them into a connection URI that carries no password, so a socket selecting vector stores admits it and a consumer reaches it with a PostgreSQL client. Realized two ways, both self-hosted and both fetching nothing: reach for the Helm Recipe on Kubernetes, which synthesizes a StatefulSet with a persistent volume, and for the Compose Recipe for local development. Its Recipes are verified by their rendered output, not by a started server storing and querying vectors. RDS for PostgreSQL offers pgvector on PostgreSQL 12-19, but no setting of the database instance enables it in a database, only a CREATE EXTENSION statement, so no RDS Recipe realizes this component. Use core/datastore/postgres on its RDS Recipes, the application running CREATE EXTENSION vector in its database; vector-store sockets do not admit it, as nothing the build sees enables the extension.

来源

官方由本目录认定为官方发布者的签名身份签名。
内容摘要
sha256:89f7d967c4cd85f0d2580c187330c84d304d1ad806488f725a3b698f21c3fbca
发布时间
2026-11-10T10:11:02Z
签名身份
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

签名

  • 官方application/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:a37dcb2454ced0e154e7ad4f9950f74284503035f55d397c2dd3cf039c2c4214

此版本的引用

oci://hub.aggrega.ai/component/core/datastore/pgvector:1.0.0

开发者参数

开发者在 Aggregate 中设置的值。

名称类型默认值必需描述
databasestringappdb否Logical database name created on startup (POSTGRES_DB), with the vector extension enabled in it.
userstringappuser否Bootstrap superuser role created on startup (POSTGRES_USER), owner of the initial database.
encodingstring—否Database encoding passed to initdb (e.g. UTF8). Omit to use the image default.
localestring—否Database locale passed to initdb (e.g. en_US.utf8). Omit to use the image default.
custom_configstring—否Raw server configuration block (postgresql.conf format), applied as the server's configuration file in place of the image's own, so a setting it omits takes the server's built-in default. listen_addresses is the one worth naming: its built-in default accepts local connections only, so a block for a server other workloads reach sets it, for example listen_addresses = '*'. The listen port comes from infra.port; a port setting here takes precedence and moves the server off the port the component publishes.

运维规格

运维人员按环境调整的基础设施规格。

名称类型默认值必需描述
portinteger (min 1024, max 65535)5432否Server listen port. Most operators should omit this and let the Recipe assign the default (5432). Every Recipe hands it to the server as its own port, so the server, its health checks and the published address all follow it.
engine_versionstring0.8.7-pg18-trixie否Tag of the pgvector/pgvector image the Recipes run. One compound coordinate carries three parts: the extension version, the PostgreSQL major version it is built for, and the Debian release it is built on — so an operator supplies a value shaped like 0.8.7-pg18-trixie rather than a bare major version, for which the image publishes no tag. The build halts on a value naming no PostgreSQL major, or a major below 18, because the Recipes keep the data where the PostgreSQL 18 and later builds place it.
computeobject—否—
storageobject—否—
overridesobject (open)—否Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

输出契约

此组件通过 uses 拓扑向使用方发布的值。

名称类型默认值必需描述
hoststring—是Address a client opens its database connection to. On Kubernetes it is the Service's DNS name, and on Compose the service name.
portinteger—是TCP port the server accepts connections on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming 5432.
userstring—否Name of the login role a consumer authenticates as. The matching password arrives through the credential attached to the component, never through this contract.
databasestring—否Name of the logical database created at startup, the one the vector extension is enabled in. A consumer names it in its connection string to land in the right database rather than the server's default.
protocolstring—否Wire protocol the published address speaks — `postgres`, so a consumer stores and queries vectors with an ordinary PostgreSQL driver.
endpointstring—否Connection URI of the component's database, postgresql://<user>@<host>:<port>/<database>, for a consumer that takes one address rather than its parts. It carries no password, which arrives through the credential attached to the component. The user and the database are written into it as given, so a name holding a character a URI reserves, such as @, : or /, breaks it.

uses 套接字

此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。

未声明 uses 套接字。

附加槽位

Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。

槽位选择器必需注入敏感描述
passwordfeature.aggrega.ai/kind=secret否env是Optional database password credential. When attached, supplies POSTGRES_PASSWORD via the credential subsystem. Unattached, compose/pgvector and helm/pgvector set POSTGRES_PASSWORD to the development literal `apppass`, which this catalog publishes, so every Release that leaves the slot unattached shares that password.

自注入允许列表

env

关系

与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。

使用

此实体未使用目录中的任何内容。

被使用

Component 概念参考 →

Aggrega 目录 — 收录组件、功能、配方以及渲染它们的插件的开放索引。

基于共享的 Aggrega 设计系统构建。

隐私