[kou]

Rationale for this change

If we use *arrow_table, TableBatchReader(const Table& table) is used instead of TableBatchReader(std::shared_ptr<Table> table). The former doesn't own the table. So the table may be freed while the TableBatchReader is still alive.

For example, an exported stream keeps the TableBatchReader alive after the GArrowTableBatchReader is freed.

What changes are included in this PR?

Use std::shared_ptr<Table> instead of const Table&.

Are these changes tested?

Yes.

Are there any user-facing changes?

Yes.

Was AI used for this PR?

In accordance to the AI generation guidelines, please disclose below whether and how AI was used in this PR.

PR code and description written by:

• Human
• AI

Reviewed before submission by:

• Human
• AI
• Not reviewed

• GitHub Issue: [Ruby] Exported Arrow::TableBatchReader crashes after GC when its table is not referenced #54689

[github-actions]

⚠️ GitHub issue #54689 has been automatically assigned in GitHub to PR creator.

[Copilot]

🟢 Approval recommended

No active review issues remain for the table-reader lifetime fix.

No open issues 🎉

What changed in this PR

Fixes the table-lifetime issue behind #54689, where importing an exported table-reader stream could crash after garbage collection.

Changes:

• Uses the owning TableBatchReader constructor so the underlying table stays alive with the reader.
• Adds a regression test that imports and reads an exported stream after releasing the table reference and running garbage collection.

File	Description
c_glib/​test/​test-table-batch-reader.rb	Adds garbage-collection regression coverage with a GI bindings version guard.
c_glib/​arrow-glib/​reader.cpp	Passes the table’s shared pointer to retain ownership in the C++ reader.

_{Review effort: Balanced}

[kou]

@himotoyoshi Could you try this?

[himotoyoshi]

Thanks! With this applied to 26.0.0 together with #54883, #55329 and #55333, the reproducer in #54689 no longer crashes. read_all returns the table with [1, 2, 3]. Without this PR it still segfaults.

c_glib and red-arrow ext rebuilt against Homebrew’s Arrow C++ 26.0.0; macOS 15.4.1 arm64, Ruby 3.4.1

[kou]

Thanks. I'll merge this.