webhookやログは、raw.stripe_webhooks.payloadのように、STRINGの列にJSONのテキストとして届くことがよくあります。BigQueryは、それをJSONPathで読みます:
JSON_VALUE(payload, '$.type')は、スカラーをSTRINGとして返します。テキスト、数値、ブール値のどれもテキストとして返されます。
JSON_QUERY(payload, '$.data.object')は、JSONの一部(オブジェクトまたは配列)をJSONのテキストとして返します。
JSON_QUERY_ARRAY(payload, '$.data.object.lines')は、UNNESTできる配列を返します。
JSON_VALUEは常に文字列を返すため、計算の前に数値をキャストしてください:CAST(JSON_VALUE(payload, '$.data.object.amount_paid') AS INT64)。Stripeは金額をペンスで送るため、100で割ります。
古いコードではJSON_EXTRACT_SCALARとJSON_EXTRACTを使っていますが、これらはJSON_VALUEとJSON_QUERYと同じことをします。BigQueryにはネイティブのJSON型もありますが、このテーブルは、多くの元データの受け入れ用のテーブルと同じく、テキストのまま保持しています。