คำแนะนำในการย้ายข้อมูล

การเปิดตัวข้อมูลเชิงลึกเกี่ยวกับสถานที่ในวันที่ 4 กันยายน 2025 มีการเปลี่ยนแปลงจากรุ่นแรกดังนี้

  • รองรับความสามารถในการสมัครรับข้อมูลข้อมูลเชิงลึกเกี่ยวกับสถานที่ในตำแหน่ง BigQuery ที่คุณเลือก

  • ย้ายชุดข้อมูลข้อมูลเชิงลึกเกี่ยวกับสถานที่จาก Data Clean Room ไปยังข้อมูล BigQuery การแลกเปลี่ยน ข้อมูล

  • ฟิลด์ที่อยู่ในสคีมาของชุดข้อมูลจะแยกฟิลด์ id และ name ออกเป็นฟิลด์สตริงหรืออาร์เรย์สตริงที่ไม่ต่อเนื่อง

ย้ายข้อมูลไปยังข้อมูล

การเปิดตัวเวอร์ชันตัวอย่างเริ่มต้นของข้อมูลเชิงลึกเกี่ยวกับสถานที่ได้ติดตั้งใช้งานข้อมูลใน BigQuery ห้องทำความสะอาดข้อมูล ในการเปิดตัววันที่ 4 กันยายน 2025 เราได้ย้ายชุดข้อมูลไปยังข้อมูล BigQuery เพื่อให้คุณสมัครใช้ชุดข้อมูลในภูมิภาค BigQueryที่เฉพาะเจาะจงได้ การเปลี่ยนแปลงนี้จะไม่มีผลต่อฟีเจอร์ผลิตภัณฑ์และความสามารถในการใช้งานข้อมูลเชิงลึกเกี่ยวกับสถานที่

หากต้องการสมัครรับข้อมูลข้อมูลเชิงลึกเกี่ยวกับสถานที่ในภูมิภาคที่เฉพาะเจาะจง คุณจะต้อง สมัครรับข้อมูลข้อมูลใหม่ใน BigQuery Sharing เมื่อสมัครใช้ข้อมูลใหม่แล้ว คุณก็ไม่จำเป็นต้องแก้ไขการค้นหา SQL แต่จะยัง ทำงานได้เหมือนเดิม

  • ผู้ใช้ใหม่: หากคุณเป็นผู้ใช้ข้อมูลเชิงลึกเกี่ยวกับสถานที่รายใหม่ ให้ทำตามขั้นตอนใน ตั้งค่าข้อมูลเชิงลึกเกี่ยวกับสถานที่เพื่อ กำหนดค่าสภาพแวดล้อมการพัฒนาสำหรับการเข้าถึงข้อมูล

  • ผู้ใช้เดิม: ทำตามขั้นตอนด้านล่างเพื่อย้ายข้อมูลไปใช้ข้อมูล

ขั้นตอนการย้ายข้อมูล

หากต้องการย้ายข้อมูลไปยังข้อมูล คุณต้องดำเนินการดังนี้

  1. ติดตามข้อมูลสำหรับเมืองและประเทศที่คุณเลือก โปรดดูวิธีการที่หัวข้อตั้งค่าข้อมูลเชิงลึกเกี่ยวกับสถานที่

  2. อัปเดตชื่อชุดข้อมูลในคำค้นหาหรือฟังก์ชันเป็นชื่อชุดข้อมูลที่คุณเลือกไว้ด้านบน

  3. หากก่อนหน้านี้คุณใช้ฟังก์ชัน ให้นำชื่อโปรเจ็กต์ที่ใช้กับคลีนรูมข้อมูลออก (maps-platform-analytics-hub)

  4. แก้ไขการค้นหาหรือฟังก์ชันที่มีอยู่ให้รวมชื่อโปรเจ็กต์ (ไม่บังคับ) และฟิลด์ที่อยู่ใหม่

ระบุชื่อโปรเจ็กต์เมื่ออ้างอิงข้อมูล (ไม่บังคับ)

เมื่อใช้ข้อมูล คุณจะใส่ชื่อโปรเจ็กต์ในการค้นหาได้ หากไม่ ระบุชื่อโปรเจ็กต์ คำค้นหาจะใช้โปรเจ็กต์ที่ใช้งานอยู่โดยค่าเริ่มต้น

คุณอาจต้องระบุชื่อโปรเจ็กต์หากลิงก์ชุดข้อมูลที่มีชื่อเดียวกันในโปรเจ็กต์ต่างๆ หรือหากกำลังค้นหาตารางภายนอกโปรเจ็กต์ที่ใช้งานอยู่

ตัวอย่างการค้นหาที่อัปเดตพร้อมชื่อโปรเจ็กต์และชื่อชุดข้อมูล

การค้นหานี้มีชื่อโปรเจ็กต์และใช้ชื่อชุดข้อมูล my_dataset_name ดังนี้

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`

ย้ายข้อมูลไปยังช่องที่อยู่ใหม่

ในการเปิดตัวข้อมูลเชิงลึกเกี่ยวกับสถานที่ครั้งแรก สคีมาชุดข้อมูลแสดงฟิลด์ที่อยู่เป็น STRUCT หรือ RECORD ที่มีฟิลด์ย่อย id และ name การเปิดตัวนี้จะทำให้สคีมาแบนราบเพื่อกำหนดฟิลด์ระดับบนสุดที่แยกกันสำหรับ id และ name ฟิลด์ใหม่จะเป็นฟิลด์สตริงหรืออาร์เรย์สตริง

เช่น สคีมาสำหรับคอมโพเนนต์ที่อยู่ของสถานที่ตั้งสำหรับการเปิดตัวครั้งแรก แสดงอยู่ด้านล่าง

locality STRUCT
  locality.id STRING
  locality.name STRING

ในการเผยแพร่นี้ ชุดข้อมูลจะมีฟิลด์อาร์เรย์สตริงระดับบนสุด 2 รายการ ตัวอย่างเช่น สคีมาข้อมูลสถานที่ที่อัปเดตแล้วแสดงอยู่ด้านล่าง

locality_ids ARRAY<string>
locality_names ARRAY<string>

ดูการอ้างอิงรูปแบบทั้งหมด

ฟิลด์ที่ไม่ใช่อาร์เรย์

ในรุ่นนี้ ตอนนี้ช่อง id และ name เป็นช่อง STRING ระดับบนสุด สำหรับช่องที่อยู่ที่ไม่ใช่อาร์เรย์แล้ว

administrative_area_level_1_id STRING
administrative_area_level_1_name STRING

รูปแบบใหม่นี้ใช้กับทุกช่องในแบบฟอร์ม administrative_area_level_N โดยที่ N คือ 1 ถึง 7

ตัวอย่างการใช้ช่องใหม่

ในการเปิดตัวข้อมูลเชิงลึกเกี่ยวกับสถานที่ครั้งแรก คุณใช้ฟิลด์ administrative_area_level_1.name ในคําสั่ง WHERE เพื่อกรองผลลัพธ์ ดังนี้

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";

เมื่อใช้ฟิลด์ใหม่ คุณจะเขียนการค้นหาโดยใช้ฟิลด์ administrative_area_level_1_nameได้ดังนี้

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";