プロンプトと適用範囲
あるチームが、既存の JSON-LD 利用者をサポートし続けながら、YAML-LD でデータコントラクトやナレッジグラフの設定を作成したいと考えています。セマンティックの等価性を検証し、YAML 機能の制限に対処し、パーシングを安全に行い、導入ゲートを設定する方法を説明してください。
W3C YAML-LD 1.0 は現在 Working Draft（草案）段階です。これは、JSON-LD の構文、セマンティクス、API を使用する YAML 上の規約として YAML-LD を定義し、すべての YAML-LD ドキュメントを JSON-LD として表現できるように、より表現力豊かな YAML 機能を制限しています。この質問では、草案が最終標準であると仮定せずに、データ形式の移行と相互運用性をテストします。
面接官が評価するポイント
面接官は、YAML の表面構文と JSON-LD のグラフセマンティクスを分離し、正規化、差分テスト、パーサーの安全性、バージョンガバナンスを定義できるかを評価します。優れた回答では、Working Draft は安定性の保証ではなく、可読性だけでは導入の価値を証明できないことを明記します。
回答前の確認質問
- 利用者は YAML を直接読み取りますか、それとも JSON-LD RDF グラフのみを受け入れますか？
- どの JSON-LD キーワード、コンテキスト、リモートドキュメント、名前空間が必要ですか？
- アンカー、エイリアス、カスタムタグ、タイムスタンプ型は存在しますか？
- パーサーの信頼境界、リソース制限、リモート
@contextポリシーはどのようになっていますか？ - どの互換性期間、バージョンネゴシエーション、ロールバック手順、最終承認者が必要ですか？
30秒の回答フレームワーク
「私は YAML-LD を Working Draft 段階の入力形式として扱い、サポートするサブセットと JSON-LD バージョンを凍結します。すべてのサンプルは、安全な YAML パーサー、YAML-LD 制約検証、JSON-LD への変換、RDF データセットの正規化、セマンティック比較を通過させ、等価に表現できない機能は拒否します。リモートコンテキストには許可リストと固定キャッシュを使用し、エイリアス、深度、サイズ、その他のリソースアクセスに制限を設けます。新フォーマットは読み取り専用の二重書き込みまたはシャドウパーシングから開始し、グラフセマンティクス、エラー、パフォーマンス、セキュリティの各ゲートを通過した後にのみ拡大します。」
ステップバイステップの詳細な回答
1. 入力と出力のコントラクトを定義する
YAML-LD ドキュメント、生成された JSON-LD、RDF データセット、利用者 API バージョンをコントラクトに含めます。サポートする JSON-LD キーワード、コンテキストソース、エンコーディング、数値ルールを凍結します。任意の YAML は YAML-LD ではありません。草案が変更されるたびに仕様とテストスイートのバージョンを記録し、異なるパーサーが暗黙のうちに乖離しないようにします。
2. まず YAML 機能を制限する
W3C は YAML が JSON よりも表現力が高いと指摘しているため、YAML-LD は JSON-LD にマッピングできる制限されたサブセットをサポートします。カスタムタグ、あいまいなタイムスタンプ型、循環エイリアス、実装固有の型を拒否または明示的に禁止します。展開された構造と JSON 表現が安定している場合にのみ、アンカーとエイリアスを許可します。作成者の記憶に頼るのではなく、実行可能な lint ルールとしてこれらの制限を組み込みます。
3. テキストの類似性ではなくグラフのセマンティクスを検証する
YAML-LD を安全にパースし、JSON-LD に変換し、コンテキストを展開して RDF データセットを生成します。正規化アルゴリズムを使用してトリプルまたはクアッドのセットを比較します。プロパティの順序、YAML のインデント、JSON のキーの順序によって結果が変わってはなりません。ノード識別子、言語タグ、型、リストの順序は明示的なチェックが必要です。文字列の diff で隠すのではなく、セマンティックな差異ごとに最小限の再現手順を保持します。
yaml = safe_parse(input, aliases=false, max_depth=32, max_bytes=1048576)
yaml_ld = validate_yaml_ld_subset(yaml)
json_ld = to_json_ld(yaml_ld)
left = normalize_rdf(json_ld)
right = normalize_rdf(reference_json_ld)
assert left == right4. パーサーのセキュリティ境界を設計する
任意のファイル、ネットワーク、コード実行機能を無効化します。リモートの @context は、バージョンを固定しサイズ制限を設けた許可リストからのみ許可します。ドキュメントサイズ、ネストの深さ、エイリアス展開、パース時間、メモリを制限し、パーサーのバージョンとコンテキストのハッシュを記録します。失敗時には位置情報を含む構造化エラーを返し、検証されていないデータをグラフストアやダウンストリームのリポジトリに書き込んではなりません。
5. 既存の利用者を保護する
コンテキスト解決、型、言語タグ、リスト、null、未知のフィールドを網羅する、すべての JSON-LD 利用者向けの互換性マトリックスを構築します。最初は JSON-LD を正規の出力として維持し、YAML-LD は作成者の入力またはシャドウパスとしてのみ使用します。変換の失敗、グラフの差異、レイテンシ、キャッシュヒット率、リソース使用量を比較します。利用者がサポートしていない機能は、本番環境で暗黙のうちに低下するのではなく、CI で失敗させる必要があります。
6. 導入ゲートとロールバックを設定する
セマンティックの一貫性、重要なフィクスチャの合格率、セキュリティスキャン、パーサーの p95、リソース制限、利用者のエラー率のしきい値を事前に定義します。Working Draft やテストスイートが変更された場合は拡大を一時停止し、古い JSON-LD ジェネレーター、コンテキストキャッシュ、入力バージョンを維持します。導入前に、反復テスト、アップグレード訓練、監査ログ、データオーナーの承認を義務付けます。草案を安定した標準として説明してはなりません。
質の高い回答例
私は YAML-LD 1.0 Working Draft を管理された入力形式として扱い、サポートする JSON-LD バージョン、キーワード、コンテキスト、および YAML サブセットを固定します。パイプラインには、サイズ、深度、エイリアス、ネットワークアクセスに制限を設けた安全なパーサーを使用します。検証後、JSON-LD への変換、コンテキストの展開、RDF データセットの正規化を行い、既存の JSON-LD ベースラインとグラフセマンティクスを比較します。キーの順序やインデントは影響を与えてはならず、ノード識別子、型、言語タグ、リストの順序は一致している必要があります。リモートコンテキストには、許可リスト、固定キャッシュ、ハッシュ監査を使用します。最初は JSON-LD を正規の出力として維持し、YAML-LD はシャドウパーシングで実行し、セマンティックな差異、パースエラー、p95 レイテンシ、メモリ、利用者のエラーに対するゲートを設けます。表現できない YAML 機能、失敗したセキュリティスキャン、または草案のアップグレードによるリグレッションが発生した場合は、拡大を停止して古いジェネレーターにロールバックします。最終承認は、Working Draft を最終標準として扱うのではなく、バージョン管理されたテストスイートとデータオーナーのサインオフに基づいて行います。
よくある間違い
- より短く、より読みやすい YAML を相互運用性の証拠として扱う → 可読性はグラフセマンティクスの等価性ではありません → 正規化された RDF データセットを比較します。
- 汎用 YAML デシリアライザーを直接使用する → YAML-LD サブセット外の型やエイリアスを受け入れてしまう可能性があります → セーフモードと制約 lint を有効にします。
- テキスト diff のみ実行する → キー順序やインデントによって誤った差異が生じます → ノード、型、言語タグ、リスト、クアッドを比較します。
- 任意のリモートコンテキストを許可する → サプライチェーン、可用性、ドリフトのリスクが制御不能になります → 許可リスト、キャッシュ、ハッシュ、制限を使用します。
- Working Draft を安定した標準と呼ぶ → 草案は変更される可能性があります → テストをバージョン管理し、段階的にロールアウトし、ロールバック出力を維持します。
フォローアップの質問と回答
なぜすべての YAML 機能を保持しないのですか？
目標は、YAML-LD ドキュメントを JSON-LD として表現できるようにすることです。安定したマッピングを持たない型、タグ、循環構造は相互運用性を損なうため、拒否するか拡張プロファイルに延期する必要があります。
2つのドキュメントが同じセマンティクスを持つことをどのように判断しますか？
生テキストではなく、コンテキストを変換および展開して正規化された RDF データセットを生成し、ノード識別子、述語、目的語、型、言語タグ、リスト順序を比較します。
なぜリモートの @context リソースを固定し、許可リストに登録するのですか？
パース処理に影響を与え、ネットワーク、サプライチェーン、バージョン乖離のリスクをもたらすためです。固定されたソース、バージョン、ハッシュ、タイムアウトにより、結果が再現可能かつ元に戻せるようになります。
YAML-LD はいつ主要な作成パスになれますか？
制約検証、セマンティック diff、セキュリティスキャン、パフォーマンス、利用者互換性、ロールバック訓練が繰り返し合格し、ドラフトバージョン、テストスイート、変更オーナーが確定された後です。
仕様の更新によってわずかなグラフの差異が生じた場合はどうしますか？
拡大を一時停止し、最小限の再現手順、仕様バージョン、コンテキストハッシュを保持し、変更が意図されたものかどうかを判断します。互換性ポリシーとデータオーナーの承認が完了するまで、古い JSON-LD の出力を継続します。