如何确认Rails迁移创建的是btree_gin索引而非普通GIN索引？

我使用Rails 6.1.7.8、Ruby 3.0.1p64（arm64-darwin21）及PostgreSQL 14.13（Homebrew）环境，编写了如下迁移文件：

class AddBtreeGinIndex < ActiveRecord::Migration[6.1]
  disable_ddl_transaction!

  def change
    enable_extension 'btree_gin'

    add_index :table_name, [:column_A, :column_B, :column_C, :column_D_with_array_of_big_int],
              name: 'sample_btree_gin_index', algorithm: :concurrently, using: :gin
  end

执行迁移后已成功启用btree_gin扩展，通过select * from pg_extension;能查到该扩展记录，但迁移创建索引时仅指定了using: :gin，我能否认为这个索引实际使用了btree_gin？又该如何确认它不是普通的GIN索引？迁移执行日志如下：

== 20241029093107 AddBtreeGinIndex: migrating ===============
  -- enable_extension("btree_gin")
-> 0.0060s
-- add_index(:table_name, [:column_A, :column_B, :column_C, :column_D_with_array_of_big_int], {:name=>"sample_btree_gin_index", :algorithm=>:concurrently, :using=>:gin})
-> 0.0162s
== 20241029093107 AddBtreeGinIndex: migrated (0.0224s) ======

能不能直接认定索引用了btree_gin？ #

不能想当然这么认为。using: :gin只是告诉PostgreSQL创建GIN类型的索引，而btree_gin扩展的核心作用是让GIN索引支持普通字段（比如你的column_A/B/C这类非数组、非全文搜索类型的字段）——如果没启用这个扩展，直接给普通字段建GIN索引会报错。

你的索引里混合了普通字段和数组字段（column_D_with_array_of_big_int）：数组字段本身就支持GIN索引，而普通字段能被加入GIN索引，全靠btree_gin提供的操作符类。所以这个索引本质还是GIN类型，但其中的普通字段部分依赖了btree_gin扩展的功能。

怎么确认索引是否依赖btree_gin？ #

可以通过以下几种PostgreSQL查询来验证：

1. 查看索引各字段的操作符类 #

执行这条SQL，把your_table_name换成实际表名：

SELECT 
  a.attname, 
  opc.opcname AS operator_class
FROM 
  pg_index i
JOIN 
  pg_class c ON i.indexrelid = c.oid
JOIN 
  pg_class t ON i.indrelid = t.oid
JOIN 
  pg_attribute a ON a.attrelid = t.oid AND a.attnum = ANY(i.indkey)
JOIN 
  pg_opclass opc ON opc.oid = ANY(i.indclass)
WHERE 
  t.relname = 'your_table_name' 
  AND c.relname = 'sample_btree_gin_index';

如果结果里column_A/B/C的operator_class是btree_xxx_gin格式（比如btree_text_gin对应文本字段，btree_int4_gin对应整数字段），就说明这些字段用了btree_gin的操作符类，索引确实依赖该扩展；数组字段的操作符类会是默认的array_ops。

2. 直接查索引依赖的扩展 #

用这条SQL可以直接看到索引关联的扩展：

SELECT 
  ext.extname
FROM 
  pg_depend dep
JOIN 
  pg_extension ext ON dep.refobjid = ext.oid
JOIN 
  pg_class idx ON dep.objid = idx.oid
WHERE 
  idx.relname = 'sample_btree_gin_index';

如果返回结果包含btree_gin，就说明这个索引依赖该扩展，必然用到了它的功能。

3. 查看索引的完整创建语句 #

用pg_get_indexdef函数生成索引的创建SQL：

SELECT pg_get_indexdef('sample_btree_gin_index'::regclass);

生成的语句里，如果普通字段后面跟着btree_xxx_gin的操作符类说明，就明确用了btree_gin；就算没显式写，只要你之前启用了扩展，PostgreSQL也是自动用了对应的操作符类，同样能证明依赖关系。

内容的提问来源于stack exchange，提问作者calvin sugianto