変更リクエスト
ブランチに push したバージョンを、差分を確認してから main にマージする手順
変更リクエストは、ブランチに push したバージョンを main にマージする前に、main との差分を確認するための仕組みです。データセットのページの「変更リクエスト」タブで作成・確認・マージします。公開データセットの変更リクエストは誰でも見られます。非公開データセットの変更リクエストと、ブランチの一覧は、データセットを持つアカウントのメンバーだけに表示されます。
承認を必須にする
「変更リクエスト」タブの「main の変更に承認を必須にする」を有効にすると、main への fdl push は拒否されます。メンバーはブランチに push して変更リクエストを作成し、アカウントの管理者がマージします。管理者は自分が作成した変更リクエストもマージできます。
この設定を変更できるのはアカウントの管理者です。無効のときは、メンバーは今までどおり main に直接 push でき、変更リクエストも使えます。
ブランチに push する
fdl branch で main からブランチを作成し、そのブランチをクローンしてビルドします。ブランチの名前は英小文字・数字・.・_・- で書き、/ で区切れます。
REPO=https://data.queria.io/datasets/<ハンドル>/<データセット>/
uvx --from fdl-cli fdl branch $REPO fix-2025
uvx --from fdl-cli fdl clone $REPO .fdl/work.sqlite --branch fix-2025
# ビルドでテーブルを書き込む
uvx --from fdl-cli fdl commit .fdl/work.sqlite -m "2025 年度の値を追加" --author <名前>
uvx --from fdl-cli fdl push .fdl/work.sqlite
fdl push はクローンしたブランチを進めます。同じブランチに続けて push すると、そのブランチから作成した変更リクエストにも反映されます。
変更リクエストを作成する
データセットのページの「変更リクエスト」タブで「変更リクエストを作成」を押し、ブランチ・タイトル・説明を入力して「作成」を押します。変更リクエストの画面には、main との差分(テーブルの追加・削除、行数、列の追加・削除・型の変更、説明の変更)と、ブランチのバージョンの一覧が表示されます。
データが変わったテーブルには、列ごとの NULL 数・異なる値の数・最小値・最大値のうち、main から変わったものが表示されます。「行の差分を表示」を押すと、main にだけある行(削除)とブランチにだけある行(追加)を先頭の 200 行まで表示します。テーブルに主キー(primary_key)があれば、主キーが同じ削除と追加の組を「変更」として数え、値が変わった列を強調します。「SQL で確認する」を押してテンプレートを選ぶと、main とブランチのバージョンを base と head として読める SQL の入力欄が開き、差分を SQL で集計できます。テンプレートはテーブルの変更に当てはまるものだけが表示されます。
- 「行の差分」: 削除された行と追加された行
- 「値が変わった行」: 主キーが同じ行のうち値が変わった列と、変更前・変更後の値(主キーがあるテーブルのみ)
- 「追加された列」・「削除された列」: その列の値と主キー
- 「型が変わった列」: 主キーが同じ行のうち、変更前と変更後で値が変わったもの。変換できずに NULL になった値も含みます(主キーがあるテーブルのみ)
変更リクエストは 1 人あたり 24 時間に 10 件まで作成できます。
フォークから変更リクエストを作成する
データセットに push できるのは、データセットを持つアカウントのメンバーだけです。メンバーでない人が push すると拒否され、フォークの手順が表示されます。メンバーでない人は、公開データセットをフォークし、フォークのブランチから変更リクエストを作成します。
- データセットのページの「フォーク」を押し、フォークの名前を入力して「フォーク」を押します。名前は最初はフォーク元と同じで、同じ名前のデータセットを既に持っているときは別の名前にします。自分のアカウントに公開データセットが作成され、フォーク元の main の最新バージョンがコピーされます。コピーが終わるまで、見出しに「フォーク元のデータをコピーしています。」と表示されます。コピーした量は自分のアカウントの容量に数えます
- フォークにブランチを作成して push します。手順は上の「ブランチに push する」と同じで、
REPOにはフォークの URL(https://data.queria.io/datasets/<自分のハンドル>/<フォークの名前>/)を指定します。dataset.jsonのnameはフォーク元の名前のままにします - フォークのページの「変更リクエスト」タブで「変更リクエストを作成」を押し、「マージ先」でフォーク元を選んで作成します。変更リクエストはフォーク元のデータセットに作成されます
CLI では次のように操作します。
queria dataset fork <ハンドル>/<データセット>
# コピーが終わってから
uvx --from fdl-cli fdl branch https://data.queria.io/datasets/<自分のハンドル>/<データセット>/ fix-2025
queria dataset clone <自分のハンドル>/<データセット> --branch fix-2025
# ビルドでテーブルを書き込み、fdl commit と fdl push を実行する
queria dataset request create <ハンドル>/<データセット> --head <自分のハンドル>/<データセット> --branch fix-2025 --title "2025 年度の値を追加"
フォークで追加したバージョンとデータファイルは、マージするまでフォークに置かれ、フォークのアカウントの容量に数えます。マージすると、それらがフォーク元にコピーされ、フォーク元のアカウントの容量に数えます。同じブランチに続けて push すると、変更リクエストにも反映されます。マージはフォーク元のアカウントの管理者が行います。
フォーク元でデータを取り下げると、フォークからも同じデータを取り下げます(データを取り下げる)。
フォークはデータセット一覧と検索に表示されません。検索欄に fork:true と書くと、フォークも表示されます。
フォークを同期する
フォーク元に新しいバージョンがあると、フォークのページの見出しに「フォーク元に新しいバージョンがあります。」と「同期」が表示されます。表示されるのは、フォークを持つアカウントのメンバーだけです。「同期」を押すと、フォーク元の main の最新バージョンがフォークにコピーされ、コピーが終わると main がそのバージョンに進みます。コピーした量は自分のアカウントの容量に数えます。
フォークの main に独自のバージョンを push していると、「フォーク元とこのデータセットの main が分かれています。」と表示されます。この場合、「同期」はフォーク元の最新バージョンをコピーするだけで、main は進みません。コピーが終わったら、見出しに表示される fdl merge <バージョン> <データセット名>.sqlite を、fdl clone を実行したフォルダで実行し、push して取り込みます。
マージする
アカウントの管理者には、アカウントのページの「承認待ちの変更リクエスト」に、アカウントのデータセットの開いている変更リクエストが表示されます。
アカウントの管理者が変更リクエストの画面で「マージ」を押すと、main がブランチのバージョンに進みます。公開中のバージョンが入れ替わるのは、fdl push で main を進めたときと同じです。
変更リクエストを作成した後に main が更新されているときは、「マージ」を押すと Queria が main にブランチのバージョンをマージし、マージのバージョンを main にします。ブランチは変わりません。テーブル・行・説明の結合の規則は FDL のマージと同じです。
main とブランチが同じテーブルや同じ行を別々に変更していて競合するときは、何も変更されず、変更リクエストの画面に競合したテーブルと行の一覧が表示されます。ブランチを修正して push してから、もう一度「マージ」を押してください。
手元で fdl merge してから main に fdl push した場合も、ブランチのバージョンが main の履歴に入った変更リクエストはマージ済みになります。
マージしない変更リクエストは「クローズ」で閉じます。作成した人とアカウントの管理者が閉じられます。「再オープン」で開き直せるのは、アカウントの管理者と、自分で閉じた変更リクエストの作成者です。
コードから作るデータセット
GitHub Actions の Apply がコードから作るデータセット(apply ブランチがあるデータセット)では、Apply がビルドのたびに apply ブランチにバージョンを追加して main にマージします。main で説明や行を変更すると、Apply は main に自動でマージせず、apply ブランチから変更リクエストを作成します。この変更リクエストは main の変更と競合することがあります。データと説明は GitHub のリポジトリで変更してください。データの誤りは元データの公開元に報告してください。
