Supabaseストレージ 連携

Supabase 連携では、RankTurn のデータベースではなく ご自身の外部 Supabase プロジェクト のテーブルに記事を直接公開します。公開した記事は選択したテーブルの 1 行として保存され、記事の各項目（タイトル・本文・スラッグなど）は、あなたが指定したカラムに書き込まれます。Supabase から直接コンテンツを読み込むブログやアプリ（例: Supabase をバックエンドにした Next.js・SvelteKit・Flutter のフロントエンドなど）に最適です。

接続は 3 ステップで行います。プロジェクトの情報を入力すると、RankTurn がプロジェクト内のテーブルとカラムを読み取り、記事の各項目をカラムに対応づけます。接続後は、記事の公開・スケジュール設定時に Supabase が公開先として表示されます。

Supabase の接続には有料プランへの加入が必要です。無料プランでは接続（およびテーブルの読み取り）はご利用いただけません。

入力した情報の保存方法については 認証情報とセキュリティ を参照してください。

接続

Supabase 接続ウィザードは 3 ステップで構成されます。設定 → 連携 を開き、Supabase カードの 接続 をクリックします（すでに接続済みの場合は 設定を編集）。

ステップ 1 — 接続情報

次へ をクリックすると、RankTurn は URL を確認し（安全のため内部・プライベートアドレスはブロックします）、プロジェクトに接続してテーブルを一覧表示します。

サービスロールキーは強力なシークレットで、プロジェクトへのフルアクセス権を持ちます。RankTurn は暗号化して保存し、再表示することはありません。後から 設定を編集 する際、キー欄は空欄です。保存済みのキーを維持する場合は空欄のまま、置き換える場合のみ新しい値を入力してください。

ステップ 2 — テーブルの選択

選択したスキーマ内で見つかったテーブルが一覧表示されます。記事を追加する 1 つのテーブルを選び、次へ をクリックします。

ステップ 3 — カラムのマッピング

選択したテーブルのカラム（各カラムにデータ型が併記されます）のドロップダウンと、各記事フィールドが並んで表示されます。妥当な対応づけがあらかじめ入力され（フィールドとカラムの対応づけ を参照）、任意に変更できます。

• タイトル と 本文（Content） は 必須 です。両方をカラムに対応づけるまで完了できず、いずれかが未設定の間は警告が表示されます。
• それ以外のフィールドは任意です。書き込みたくないフィールドは なし（None） を選択します。
• このステップで コンテンツ形式 と ステータス値 も設定します（後述）。

接続 をクリックして完了します。RankTurn はまず接続テストを実行し、成功した場合のみ接続を保存します。

フィールドとカラムの対応づけ

標準的な手順では、プロジェクト側でセットアップ用のコマンドを実行する 必要はありません。RankTurn はサービスロールキーを使ってテーブルとカラムを読み取ります。

仕組み。RankTurn はプロジェクトのテーブル構造を読み取り、テーブルとそのカラム・型を取得します。それを直接読み取れない場合は、よくあるコンテンツ用テーブル名（posts、articles、blog_posts、content、pages、blogs、news、stories）を探し、既存の行からカラムを推測します。内部のシステムテーブルは除外されます。読み取った内容は保存されるため、後で接続を編集する際に再度読み取り直す必要はありません。

自動対応づけ。テーブルを選択すると、RankTurn はよくあるカラム名（大文字・小文字を区別しない）に基づいて各記事フィールドのカラムを提案します。例:

一覧には 更新日時（Updated At） と 作成日時（Created At） のフィールドも含まれ、それぞれ記事の最終更新日・作成日を保持します。各フィールドは記事が実際にその日付を持つ場合にのみ書き込まれます。1 点注意があります。created_at という名前のカラムは 作成日時 ではなく 公開日時（Published At） フィールドに対応づけられるため、公開日時で埋まります。記事本来の作成日をそこに入れたい場合は、作成日時 フィールドをご自身で対応づけてください。

自動対応づけはあくまで出発点です。すべての対応づけを確認し、誤ったカラムを指しているものは修正してください。なし のまま残したフィールドは書き込まれず、値を持たない任意フィールドは空で書き込むのではなくスキップされます。

スラッグによる行の再利用。スラッグ フィールドをカラムに対応づけ、記事に固有のスラッグが設定されている場合、RankTurn はまずそのスラッグを持つ既存行を探し、重複を追加せず 更新 します。これにより、同じ記事を再公開しても 2 つ目のコピーが作られません。テーブルはあなた自身のものなので、RankTurn は対応づけたスラッグカラムを手がかりに、以前公開した行かどうかを判断します。なお、タイトルから自動生成されたスラッグはこの判断に 使用されません。異なる記事同士の衝突を避けるため、その場合は常に新しい行を追加します。再公開で更新したい場合は、固有のスラッグカラムを対応づけてください。

コンテンツ形式とステータス値

マッピングステップにある 2 つの設定が、記事データの書き込まれ方を制御します。

コンテンツ形式

コンテンツ形式 の設定は、本文 カラムに書き込む形式を指定し、サイトがそのカラムをどう表示するかに合わせます。

ステータス値

ステータス カラムを対応づけると、RankTurn は公開のたびに固定のステータス語を書き込みます。この値は接続時に設定でき、既定は published です。サイトが想定する表記（例: public、live、published）に合わせてください。

画像

記事は複数種類の画像情報を持つことができ、それぞれカラムを対応づけ、かつ記事が実際にその画像を持っている場合にのみ書き込まれます。

• サムネイル URL — 記事のカバー画像・アイキャッチ画像のリンク。テキスト/URL カラム（例: featured_image、cover_image）に対応づけます。
• サムネイル代替テキスト — そのカバー画像の代替テキスト。テキストカラムに対応づけます。
• インライン画像 — 本文内で使われている画像の一覧で、リストとして書き込まれます。自動対応づけは json/jsonb カラム（images または inline_images）にのみ提案します。リストがきれいに保存されるよう JSONB カラムに対応づけてください。

RankTurn は画像ファイル自体をプロジェクトにコピーしません。すでにホスティングされている画像の リンク（サムネイルのリンクとインライン画像のリンク）を書き込むだけです。サイトはそれらのリンクから画像を読み込みます。画像ファイルそのものを自前のストレージに置きたい場合は、それらのリンクから別途ダウンロードしてください。

ヒントとトラブルシューティング

「セットアップが必要」/ テーブルが見つからない。サービスロールキー が service_role キーであること（anon キーではない）と、データベーススキーマ 名が正しいことを確認してください。読み取りにはサービスロールキーがテーブルを読み取れる必要があります。

接続テストに失敗する。プロジェクト URL（https://<project-ref>.supabase.co の形式）とサービスロールキーを再確認してください。プライベート・内部アドレスを指す URL も拒否されます。

サイト上で常に下書き扱いになる。ステータス カラムを対応づけ、ステータス値 をサイトが公開済みとみなす値（例: published、public）に設定してください。

タグや画像が括弧付きのテキストとして保存される。タグ と インライン画像 はプレーンテキストではなく配列/JSONB カラムに対応づけてください。値が引用符付き文字列として保存されるのを防げます。なお カテゴリ の対応づけは単数で、プレーンテキストとして書き込まれます。

再公開で行が重複する。スラッグ フィールドをカラムに対応づけ、記事に固有のスラッグを設定すると、RankTurn は新規追加の代わりに既存行を検索して更新します。

この連携の情報の暗号化と保存については 認証情報とセキュリティ を、スケジュール設定や自動公開については 公開とスケジュール を参照してください。