DocsDigest
Back to listLanguage: JA
OpenAICloudflare Developer PlatformJul 13, 2026, 12:00 AM

R2 - R2 Data Catalog now supports read-only API tokens

A condensed section focused on the key takeaways first.

Original Post
OpenAIClaude

Quick Digest

Summary

A condensed section focused on the key takeaways first.

openaienmodel: gpt-5-mini-2025-08-07

R2 Data Catalog: Read-only API tokens

r2data-catalogapi-tokensread-onlyicebergauthorizationduckdb

Key Points

  • Supports read-only API tokens
  • Enables least-privilege for query engines
  • Vended credentials inherit storage permissions

Summary

Cloudflare R2 Data Catalog now accepts read-only API tokens so clients that only read data no longer need read-write tokens. Read-only operations (listing namespaces, loading tables, querying data) can use an Admin Read-only token (R2 Data Catalog read + R2 storage read). Write operations (creating/dropping tables, committing transactions) still require an Admin Read & Write token.

Key Points

  • Read-only operations (list namespaces, load tables, query data) work with an Admin Read-only token.
  • Write operations (create/drop tables, commit transactions) still require an Admin Read & Write token.
  • Catalog-vended credentials inherit the R2 storage permissions of the authenticating token.
  • To ensure underlying data is read-only, scope the R2 storage permission to read-only as well.
  • Follow least-privilege: use read-write tokens for writers and read-only tokens for query engines (e.g., R2 SQL, DuckDB, PyIceberg).
  • See the docs section "Authenticate your Iceberg engine" for token selection and creation details.

Full Translation

Translations

A translation section that keeps the flow of the original article.

openaijamodel: gpt-5-mini-2025-08-07

R2 - R2 Data Catalog が読み取り専用 API トークンをサポートするようになりました

R2 Data Catalog が読み取り専用 API トークンをサポートするようになりました

Jul 13, 2026 · R2

R2 Data Catalog は読み取り専用の API トークンを受け付けるようになりました。これにより、クエリエンジンやクライアントがデータを読み取るだけの場合、もはや読み取り／書き込みトークンを使用する必要はありません。以前はすべてのカタログ操作に Admin Read & Write token が必要で、読み取り専用クライアントに過剰な権限が付与されていました。

変更点

  • ワークロードに応じた認証が可能になりました。
  • 読み取り専用操作（名前空間の一覧表示、テーブルの読み込み、データのクエリなど）は Admin Read only token（R2 Data Catalog read および R2 storage read）で動作します。
  • 書き込み操作（テーブルの作成や削除、トランザクションのコミットなど）は引き続き Admin Read & Write token を要求します。

利点

  • 最小権限の原則に従えます。たとえば、テーブルに書き込むパイプラインは読み書きトークンを使用し、R2 SQL、DuckDB、PyIceberg のようなクエリエンジンは読み取り専用トークンを使用できます。

注意事項

  • カタログが発行する認証情報は、認証に使用したトークンの R2 storage 権限を継承します。基盤データへの読み取り専用アクセスを確実にするには、R2 storage の権限も読み取り専用にスコープしてください。

詳細

  • トークンの選択と作成方法については、Authenticate your Iceberg engine を参照してください。