データストアスキーマ変更手順¶

Discovery Engine のスキーマを変更する際の手順と、使用するスクリプトの説明です。

スキーマ変更手順¶

スキーマの変更はデータストアの再作成（destroy → create）になるため、事前にドキュメントを削除する必要があります。

全ドキュメント削除 → terraform apply → ドキュメントインポート

json_schema を編集して変更内容をコミットします。

./datastore_scripts/delete_datastore_documents.sh <PROJECT_ID>

例:

./datastore_scripts/delete_datastore_documents.sh sorarun-iac-demo

⚠️ purge は非同期処理です。GCPコンソールで削除完了を確認してから次のステップへ進んでください。

cd environments/<ENV_DIR>/setup
terraform apply -var-file="<ENV_NAME>.tfvars"

例:

cd environments/sorarun-iac-demo/setup
terraform apply -var-file="terraform.tfvars"

./datastore_scripts/import_datastore_documents.sh <PROJECT_ID>

例:

./datastore_scripts/import_datastore_documents.sh sorarun-iac-demo

指定プロジェクトの全データストアのドキュメントを削除します。 Discovery Engine の purge API を使用して一括削除します。

./datastore_scripts/delete_datastore_documents.sh <PROJECT_ID> [FOLDERS]

引数	必須	説明
PROJECT_ID	✅	GCPプロジェクトID
FOLDERS	-	スペース区切りのフォルダ名（省略時はtfvarsから自動取得）

syncDatastore Cloud Function を全フォルダに対して呼び出し、GCSからドキュメントをインポートします。

./datastore_scripts/import_datastore_documents.sh <PROJECT_ID> [FOLDERS]

引数	必須	説明
PROJECT_ID	✅	GCPプロジェクトID
FOLDERS	-	スペース区切りのフォルダ名（省略時はtfvarsから自動取得）

google_discovery_engine_schema リソースを Terraform state にインポートします。新規環境セットアップ時や state が失われた場合に使用します。

./datastore_scripts/tf_import_discoveryengine_schema.sh <ENV_DIR> <PROJECT_ID> [FOLDERS]

引数	必須	説明
ENV_DIR	✅	Terraformディレクトリ（例: `environments/sorarun-iac-demo/setup`）
PROJECT_ID	✅	GCPプロジェクトID
FOLDERS	-	スペース区切りのフォルダ名（省略時はtfvarsから自動取得）