Knex(PostgreSQL)如何设置仅当orgId匹配时name列唯一的表结构？

你需要的是orgId和name两列的联合唯一约束，通过这个约束就能保证同一个orgId下不会出现重复的name值，完整实现方式如下：

新建表时添加约束的写法 #

exports.up = function(knex) {
  return knex.schema.createTable('你的表名', function (table) {
    // 基础字段定义
    table.increments('id').primary();
    table.string('name').notNullable();
    table.integer('orgId')
      .notNullable()
      .references('id')
      .inTable('你实际的组织表名') // 替换为orgId关联的主表名称
      .onDelete('CASCADE'); // 可根据业务需求调整外键删除/更新策略
    
    // 核心：添加orgId和name的联合唯一约束
    table.unique(['orgId', 'name'], {
      indexName: 'org_name_unique', // 可选，自定义约束索引名方便后续维护
      deferrable: 'immediate' // 可选，根据所用数据库支持调整约束校验时机
    });
  });
};

exports.down = function(knex) {
  return knex.schema.dropTable('你的表名');
};

已有表新增约束的迁移写法 #

如果表已经创建完成，需要新增该约束，使用以下迁移代码即可：

exports.up = function(knex) {
  return knex.schema.alterTable('你的表名', function (table) {
    table.unique(['orgId', 'name'], { indexName: 'org_name_unique' });
  });
};

exports.down = function(knex) {
  return knex.schema.alterTable('你的表名', function (table) {
    table.dropUnique(['orgId', 'name'], 'org_name_unique');
  });
};

注意事项 #

• 给已有表加约束前，请先确认表中现有数据不存在同orgId下重复name的情况，否则迁移会执行失败
• MySQL、PostgreSQL等主流数据库均支持该联合唯一约束写法，MySQL会自动为唯一约束生成对应的唯一索引，无需额外创建
• 外键的关联配置请根据你实际的表结构调整

内容的提问来源于stack exchange，提问作者Kinara Nyakaru