n8n 中文文档

Postgres 节点

使用 Postgres 节点在 Postgres 中自动化工作,并将 Postgres 与其他应用程序集成。n8n 内置支持广泛的 Postgres 功能,包括执行查询,以及在数据库中插入和更新行。

在此页面上,您将找到 Postgres 节点支持的操作列表和更多资源的链接。

提示

Credentials 凭证

有关设置身份验证的指南,请参阅 Postgres 凭据。

提示

This node can be used as an AI tool 该节点可用作AI工具

该节点可用于增强人工智能代理的能力。以这种方式使用时,可以自动设置许多参数,或者使用 AI 指导的信息 - 在 AI 工具参数文档 中了解更多信息。

操作

删除

使用此操作删除整个表或表中的行。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Postgres 凭证。
  • Operation 操作:选择Delete 删除。
  • Schema 模式:选择包含要处理的表的架构。选择 From list 来自列表 从下拉列表中选择架构,或选择 By Name 按名称 输入架构名称。
  • Table 表:选择您要处理的表。选择 From list 来自列表 从下拉列表中选择表,或选择 By Name 按名称 输入表名称。
  • Command 命令:要采取的删除操作:
    • Truncate 截断:删除表的数据但保留表的结构。
      • Restart Sequences 重新启动序列:作为截断过程的一部分,是否将自动增量列重置为其初始值。
    • Delete 删除:删除符合“选择行”条件的行。如果您不选择任何内容,Postgres 将删除所有行。
      • Select Rows 选择行:定义 Column 专栏、Operator 操作员 和 Value 价值 来匹配行。
      • Combine Conditions 组合条件:如何组合“选择行”中的条件。 AND 要求所有条件都为真,而 OR 则要求至少一个条件为真。
    • Drop 掉落:永久删除表的数据和结构。

删除选项

  • Cascade 级联:是否也删除依赖于该表的所有对象,如视图和序列。使用 Truncate 截断或 Drop 丢弃命令时可用。
  • Connection Timeout 连接超时:尝试连接到数据库的秒数。
  • Delay Closing Idle Connection 延迟关闭空闲连接:在考虑空闲连接有资格关闭之前等待的秒数。
  • Query Batching 查询批处理:向数据库发送查询的方式:
    • Single Query 单个查询:为所有传入项目执行单个查询。
    • Independently 独立:为执行的每个传入项目执行一个查询。
    • Transaction 事务:在事务中执行所有查询。如果发生故障,Postgres 会回滚所有更改。
  • Output Large-Format Numbers As 输出大格式数字为:输出 NUMERIC 和 BIGINT 列的格式:
    • Numbers 数字:用于标准数字。
    • Text 文本:如果您期望数字长于 16 位,请使用此选项。否则,数字可能不正确。

执行查询

使用此操作执行 SQL 查询。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Postgres 凭证。
  • Operation 操作:选择Execute Query 执行查询。
  • Query 查询:要执行的 SQL 查询。您可以使用 n8n 表达式 和 $1、$2 和 $3 等标记来构建准备好的语句 以与查询参数 一起使用。

执行查询选项

  • Connection Timeout 连接超时:尝试连接到数据库的秒数。
  • Delay Closing Idle Connection 延迟关闭空闲连接:在考虑空闲连接有资格关闭之前等待的秒数。
  • Query Batching 查询批处理:向数据库发送查询的方式:
    • Single Query 单个查询:为所有传入项目执行单个查询。
    • Independently 独立:为执行的每个传入项目执行一个查询。
    • Transaction 事务:在事务中执行所有查询。如果发生故障,Postgres 会回滚所有更改。
  • Query Parameters 查询参数:要用作查询参数的值的逗号分隔列表。
  • Output Large-Format Numbers As 输出大格式数字为:输出 NUMERIC 和 BIGINT 列的格式:
    • Numbers 数字:用于标准数字。
    • Text 文本:如果您期望数字长于 16 位,请使用此选项。否则,数字可能不正确。
  • Replace Empty Strings with NULL 用 NULL 替换空字符串:是否在输入中用 NULL 替换空字符串。这在处理从电子表格软件导出的数据时可能很有用。

插入

使用此操作在表中插入行。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Postgres 凭证。
  • Operation 操作:选择Insert 插入。
  • Schema 模式:选择包含要处理的表的架构。选择 From list 来自列表 从下拉列表中选择架构,或选择 By Name 按名称 输入架构名称。
  • Table 表:选择您要处理的表。选择 From list 来自列表 从下拉列表中选择表,或选择 By Name 按名称 输入表名称。
  • Mapping Column Mode 映射列模式:如何将列名称映射到传入数据:
    • Map Each Column Manually 手动映射每列:选择用于每列的值。
    • Map Automatically 自动地图:自动将传入数据映射到 Postgres 中匹配的列名称。传入的数据字段名称必须与 Postgres 中的列名称匹配才能正常工作。如有必要,请考虑使用此节点之前的编辑字段(设置)节点 根据需要调整格式。

插入选项

  • Connection Timeout 连接超时:尝试连接数据库的秒数。
  • Delay Closing Idle Connection 延迟关闭空闲连接:在考虑关闭空闲连接之前等待的秒数。
  • Query Batching 查询批处理:向数据库发送查询的方式:
    • Single Query 单次查询:对所有传入项目的单个查询。
    • Independently 独立地:执行的每个传入项目执行一个查询。
    • Transaction 交易:执行事务中的所有查询。如果发生故障,Postgres 将回滚所有更改。
  • Output Columns 输出列:选择要输出的列。您可以从可用列的列表中进行选择,或使用表达式 指定 ID。
  • Output Large-Format Numbers As 将大格式数字输出为:输出 NUMERIC 和 BIGINT 列的格式为:
    • Numbers 数字:将此用于标准号码。
    • Text 文字:如果您希望数字长度超过 16 位,请使用此选项。如果没有这个,数字可能不正确。
  • Skip on Conflict 跳过冲突:如果插入违反唯一或排除约束,是否跳过该行而不是抛出错误。
  • Replace Empty Strings with NULL 将空字符串替换为 NULL:是否将输入中的空字符串替换为NULL。当处理从电子表格软件导出的数据时,这可能很有用。

插入或更新

使用此操作在表中插入或更新行。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Postgres 凭证。
  • Operation 操作:选择Insert or Update 插入或更新。
  • Schema 模式:选择包含要处理的表的架构。选择 From list 来自列表 从下拉列表中选择架构,或选择 By Name 按名称 输入架构名称。
  • Table 表:选择您要处理的表。选择 From list 来自列表 从下拉列表中选择表,或选择 By Name 按名称 输入表名称。
  • Mapping Column Mode 映射列模式:如何将列名称映射到传入数据:
    • Map Each Column Manually 手动映射每列:选择用于每列的值。
    • Map Automatically 自动地图:自动将传入数据映射到 Postgres 中匹配的列名称。传入的数据字段名称必须与 Postgres 中的列名称匹配才能正常工作。如有必要,请考虑使用此节点之前的编辑字段(设置)节点 根据需要调整格式。

插入或更新选项

  • Connection Timeout 连接超时:尝试连接数据库的秒数。
  • Delay Closing Idle Connection 延迟关闭空闲连接:在考虑关闭空闲连接之前等待的秒数。
  • Query Batching 查询批处理:向数据库发送查询的方式:
    • Single Query 单次查询:对所有传入项目的单个查询。
    • Independently 独立地:执行的每个传入项目执行一个查询。
    • Transaction 交易:执行事务中的所有查询。如果发生故障,Postgres 将回滚所有更改。
  • Output Columns 输出列:选择要输出的列。您可以从可用列的列表中进行选择,或使用表达式 指定 ID。
  • Output Large-Format Numbers As 将大格式数字输出为:输出 NUMERIC 和 BIGINT 列的格式为:
    • Numbers 数字:将此用于标准号码。
    • Text 文字:如果您希望数字长度超过 16 位,请使用此选项。如果没有这个,数字可能不正确。
  • Replace Empty Strings with NULL 将空字符串替换为 NULL:是否将输入中的空字符串替换为NULL。当处理从电子表格软件导出的数据时,这可能很有用。

选择

使用此操作从表中选择行。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Postgres 凭证。
  • Operation 操作:选择Select 选择。
  • Schema 模式:选择包含要处理的表的架构。选择 From list 来自列表 从下拉列表中选择架构,或选择 By Name 按名称 输入架构名称。
  • Table 表:选择您要处理的表。选择 From list 来自列表 从下拉列表中选择表,或选择 By Name 按名称 输入表名称。
  • Return All 返回全部:是否返回所有结果或仅返回给定限制。
  • Limit 限制:禁用 Return All 返回全部 时返回的最大项目数。
  • Select Rows 选择行:设置选择行的条件。定义 Column 专栏、Operator 操作员 和 Value 价值 来匹配行。如果您不选择任何内容,Postgres 将选择所有行。
  • Combine Conditions 组合条件:如何组合Select Rows 选择行中的条件。 AND 要求所有条件都为真,而 OR 则要求至少一个条件为真。
  • Sort 排序:选择如何对所选行进行排序。从列表中选择 Column 专栏 或按 ID 和排序 Direction 方向。

选择选项

  • Connection Timeout 连接超时:尝试连接数据库的秒数。
  • Delay Closing Idle Connection 延迟关闭空闲连接:在考虑关闭空闲连接之前等待的秒数。
  • Query Batching 查询批处理:向数据库发送查询的方式:
    • Single Query 单次查询:对所有传入项目的单个查询。
    • Independently 独立地:执行的每个传入项目执行一个查询。
    • Transaction 交易:执行事务中的所有查询。如果发生故障,Postgres 将回滚所有更改。
  • Output Columns 输出列:选择要输出的列。您可以从可用列的列表中进行选择,或使用表达式 指定 ID。
  • Output Large-Format Numbers As 将大格式数字输出为:输出 NUMERIC 和 BIGINT 列的格式为:
    • Numbers 数字:将此用于标准号码。
    • Text 文字:如果您希望数字长度超过 16 位,请使用此选项。如果没有这个,数字可能不正确。

更新

使用此操作更新表中的行。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Postgres 凭证。
  • Operation 操作:选择Update 更新。
  • Schema 模式:选择包含要处理的表的架构。选择 From list 来自列表 从下拉列表中选择架构,或选择 By Name 按名称 输入架构名称。
  • Table 表:选择您要处理的表。选择 From list 来自列表 从下拉列表中选择表,或选择 By Name 按名称 输入表名称。
  • Mapping Column Mode 映射列模式:如何将列名称映射到传入数据:
    • Map Each Column Manually 手动映射每列:选择用于每列的值。
    • Map Automatically 自动地图:自动将传入数据映射到 Postgres 中匹配的列名称。传入的数据字段名称必须与 Postgres 中的列名称匹配才能正常工作。如有必要,请考虑使用此节点之前的编辑字段(设置)节点 根据需要调整格式。

更新选项

  • Connection Timeout 连接超时:尝试连接数据库的秒数。
  • Delay Closing Idle Connection 延迟关闭空闲连接:在考虑关闭空闲连接之前等待的秒数。
  • Query Batching 查询批处理:向数据库发送查询的方式:
    • Single Query 单次查询:对所有传入项目的单个查询。
    • Independently 独立地:执行的每个传入项目执行一个查询。
    • Transaction 交易:执行事务中的所有查询。如果发生故障,Postgres 将回滚所有更改。
  • Output Columns 输出列:选择要输出的列。您可以从可用列的列表中进行选择,或使用表达式 指定 ID。
  • Output Large-Format Numbers As 将大格式数字输出为:输出 NUMERIC 和 BIGINT 列的格式为:
    • Numbers 数字:将此用于标准号码。
    • Text 文字:如果您希望数字长度超过 16 位,请使用此选项。如果没有这个,数字可能不正确。
  • Replace Empty Strings with NULL 将空字符串替换为 NULL:是否将输入中的空字符串替换为NULL。当处理从电子表格软件导出的数据时,这可能很有用。

模板和示例

浏览 n8n-nodes-base.postgres 集成模板 或 搜索所有模板

相关资源

n8n 为 Postgres 提供了一个触发节点。您可以在Postgres Trigger 触发器节点文档找到触发节点文档。

使用查询参数

当创建要运行在 Postgres 数据库上的查询时,您可以在选项部分中使用查询参数字段将数据加载到查询中。n8n 对查询参数中的数据进行消毒,以防止 SQL 注入。

例如,您想根据电子邮件地址查找人员。给定以下输入数据:

[
    {
        "email": "[email protected]",
        "name": "Alex",
        "age": 21
    },
    {
        "email": "[email protected]",
        "name": "Jamie",
        "age": 33
    }
]

您可以编写如下查询:

SELECT * FROM $1:name WHERE email = $2;

然后在查询参数中提供要使用的字段值。您可以提供固定值或表达式。对于此示例,使用表达式,以便节点可以从每个输入项目中依次拉取电子邮件地址:

// users is an example table name
{{ [ 'users', $json.email ] }}

常见问题

有关常见问题和建议的解决方案,请参阅常见问题。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。