ประเภทข้อมูลและประเภทความหมาย

เมื่อคุณสร้างปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูล แต่ละฟิลด์ที่คุณกำหนดใน สคีมา ต้องระบุประเภทข้อมูล ประเภทข้อมูลจะเป็นตัวกำหนดประเภทพื้นฐานของช่อง เช่น BOOLEAN, STRING, NUMBER ฯ

นอกจากประเภทข้อมูลแล้ว Looker Studio ยังใช้ประเภทความหมายด้วย ประเภทความหมายช่วยอธิบายชนิดของข้อมูลที่ข้อมูลดังกล่าวแสดง สำหรับ เช่น ฟิลด์ที่มีประเภทข้อมูล NUMBER อาจหมายถึงสกุลเงิน จำนวนหรือเปอร์เซ็นต์ และฟิลด์ที่มีประเภทข้อมูล STRING อาจมีความหมาย ที่แสดงถึงเมือง หากต้องการดูประเภทความหมายที่มี โปรดไปที่ เอกสารประกอบเกี่ยวกับประเภทอรรถศาสตร์

ช่องสคีมาเครื่องมือเชื่อมต่อชุมชนและ Looker Studio

เมื่อคุณกำหนดสคีมาสำหรับปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูลจะมี สำหรับแต่ละฟิลด์ที่จะกำหนดว่าจะแสดงฟิลด์นั้นอย่างไร และ ที่ใช้ใน Looker Studio เช่น

• conceptType คือ ที่กำหนดไว้ในสคีมาเครื่องมือเชื่อมต่อโดยใช้พร็อพเพอร์ตี้ conceptType ช่วงเวลานี้ จะกำหนดว่าช่องนั้นถือเป็นมิติข้อมูลหรือเมตริกหรือไม่ ดูคำอธิบายเกี่ยวกับความแตกต่างระหว่างเมตริกและมิติข้อมูลได้ ที่ มิติข้อมูลและเมตริก
• ประเภทความหมายสามารถ จะกำหนดไว้ในสคีมาเครื่องมือเชื่อมต่อ หรือมีการตรวจพบโดยอัตโนมัติ โดย Looker Studio โดยอิงจาก พร็อพเพอร์ตี้ประเภทข้อมูลที่กำหนดไว้ใน และค่าของข้อมูลที่เครื่องมือเชื่อมต่อแสดง โปรดดู การตรวจหาประเภทความหมายอัตโนมัติเพื่อดูรายละเอียดเกี่ยวกับ วิธีการทำงาน
• ประเภทการรวมจะกําหนดว่าค่าเมตริก (มิติข้อมูล) ) สามารถรวบรวมอีกครั้งได้ การตั้งค่า semantics.isReaggregatable พร็อพเพอร์ตี้เป็น true จะมีค่าเริ่มต้นเป็นการรวม SUM มิเช่นนั้นจะเป็น ตั้งค่าเป็น Auto คุณยังตั้งประเภทการรวมเริ่มต้นด้วยตนเองสำหรับ ฟิลด์ที่รวบรวมซ้ำได้โดยใช้ฟังก์ชัน defaultAggregationType

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

หมายเหตุ: ระบบใช้พร็อพเพอร์ตี้สคีมาที่กำหนดไว้ในปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูลอย่างมีประสิทธิภาพ เป็นการตั้งค่าเริ่มต้นเมื่อผู้ใช้สร้างแหล่งข้อมูล ผู้ใช้สามารถลบล้าง ของพร็อพเพอร์ตี้ ยกเว้นประเภทการรวมเมื่อตั้งค่าเป็น อัตโนมัติ

การตั้งค่าข้อมูลความหมาย

การตั้งค่าข้อมูลความหมายมี 2 วิธี คุณอาจตั้งค่าช่อง อรรถศาสตร์ด้วยตนเองหรืออาศัย Looker Studio เพื่อตรวจหาโดยอัตโนมัติ

เช่น หากคุณมีตัวเลขที่มีความหมายเป็นดอลลาร์สหรัฐ Looker Studio จะไม่สามารถตรวจหาการสื่อความหมายประเภทนี้โดยอัตโนมัติ นอกจากนี้ การตรวจหาความหมายอัตโนมัติต้องใช้ Looker Studio ในการสร้างข้อมูล ดึงข้อมูลการเรียกสำหรับแต่ละฟิลด์ของสคีมา หากคุณระบุสคีมาด้วยตนเอง ในกรณีนี้ จะไม่มีการเรียกใช้เพื่อดึงข้อมูลแทน ในกรณีที่คุณทราบว่า ประเภทความหมาย (เช่น สกุลเงิน เปอร์เซ็นต์ วันที่ ฯลฯ) สำหรับข้อมูล จากนั้นเราจะ เราขอแนะนำให้ตั้งค่านี้ในสคีมาอย่างชัดเจนเพื่อความแม่นยำและประสิทธิภาพ เหตุผล

การตั้งค่าประเภทความหมายด้วยตนเอง (แนะนำ)

หากคุณทราบประเภทความหมาย ก็จะกำหนด semantics ให้กับแต่ละประเภทได้ด้วยตนเอง สคีมา ดูรายละเอียดทั้งหมดเกี่ยวกับที่พักที่พร้อมให้บริการ ในหน้าการอ้างอิงช่อง หากคุณ เลือกที่จะกำหนดประเภทความหมายที่กำหนดเอง ขอแนะนำให้คุณกำหนด semanticType และ semanticGroup สําหรับทุกช่อง การระบุรายการเหล่านี้ด้วยตัวเอง กระบวนการตรวจหาประเภทความหมายอัตโนมัติจะไม่ทำงาน หากคุณ ตั้งค่าช่องบางช่องด้วยตนเอง แต่ไม่ใช่ทั้งหมด ให้ตั้งค่าช่องที่คุณไม่ได้ ระบุค่าเริ่มต้นเป็น Text, Number หรือ Boolean โดยขึ้นอยู่กับ dataType ที่ระบุสำหรับฟิลด์

ต่อไปนี้เป็นตัวอย่างของสคีมาแบบง่ายที่ตั้งค่าความหมายด้วยตนเอง ประเภทต่างๆ ตั้งค่า Income เป็นสกุลเงิน และตั้งค่า Filing Year เป็นวันที่

data-studio/semantics.gs

ดูใน GitHub

var schema = [
  {
    'name': 'Income',
    'label': 'Income (in USD)',
    'dataType': 'NUMBER',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'CURRENCY',
      'semanticType': 'CURRENCY_USD'
    }
  }, {
    'name': 'Filing Year',
    'label': 'Year in which you filed the taxes.',
    'dataType': 'STRING',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'DATE_OR_TIME',
      'semanticType': 'YEAR'
    }
  }
];

การแก้ปัญหาประเภทความหมายที่กําหนดเอง

หากคุณตั้งค่าประเภทความหมายสําหรับข้อมูลที่เกี่ยวข้องไม่ถูกต้อง ประเภทจะ ทำงานไม่ถูกต้อง ซึ่งอาจจะทดสอบได้ยาก แต่มี 2-3 สิ่งที่คุณ เพื่อช่วยค้นหาปัญหาได้

1. แสดงผล 2 หรือ 3 แถวจากข้อมูลของคุณแทนที่จะแสดงผลทั้งหมด จากนั้นส่งด้วยตนเอง ตรวจสอบ
2. สร้างตารางใน Looker Studio ที่ใช้เฉพาะช่องที่คุณพยายาม
3. ให้ความสำคัญกับช่อง Geo และ Date เป็นพิเศษเนื่องจากมีช่องสูงสุด รูปแบบที่เข้มงวด

การตรวจหาประเภทความหมายอัตโนมัติ

หากคุณไม่ได้กำหนดประเภทความหมายในสคีมาไว้ Looker Studio จะพยายามตรวจหาโดยอัตโนมัติ ประเภทข้อมูลและรูปแบบ ของค่าข้อมูลที่เครื่องมือเชื่อมต่อแสดงผล

หมายเหตุ: การตรวจหาประเภทความหมายอัตโนมัติจะดำเนินการก็ต่อเมื่อไม่มีช่องที่มี ระบบจะพบ semanticType และเมื่อมีการสร้างแหล่งข้อมูลใหม่หรือ สคีมาของแหล่งข้อมูลที่มีอยู่มีการเปลี่ยนแปลง

ขั้นตอนของกระบวนการตรวจหาอัตโนมัติมีดังนี้

1. ขอสคีมาโดยการเรียกใช้ getSchema ของฟังก์ชัน ปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูล
2. ทำซ้ำผ่านกลุ่มของช่องที่กำหนดไว้ในสคีมาและปัญหาของเครื่องมือเชื่อมต่อ getData ขอช่อง ระบบดำเนินการตามคำขอ getData ด้วยพารามิเตอร์ sampleExtraction ตั้งค่าเป็น true เพื่อบ่งบอกว่าคำขอข้อมูลมีขึ้นเพื่อจุดประสงค์ในเชิงความหมาย การตรวจจับ
3. อิงตามประเภทข้อมูลช่องและรูปแบบของค่าที่แสดงผลจาก คำขอ getData ระบุประเภทความหมายของช่อง

ข้อควรระวัง: การตรวจหาประเภทความหมายอัตโนมัติไม่สามารถระบุความหมายทั้งหมดได้อย่างเหมาะสม ประเภทต่างๆ สำหรับสคีมาของคุณ แต่จะตรวจจับได้เฉพาะเวลา/วันที่และประเภทความหมายทางภูมิศาสตร์เท่านั้น

ตัวเลือกสำหรับการจัดการการตรวจหาประเภทความหมายอัตโนมัติ

เมื่อ Looker Studio เรียกใช้ฟังก์ชัน getData ของปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูล มีจุดประสงค์ในการตรวจหาความหมาย คำขอที่เข้ามาจะมี พร็อพเพอร์ตี้ sampleExtraction ซึ่งจะตั้งค่าเป็น true แสดงข้อมูลโดย Looker Studio จะใช้เครื่องมือเชื่อมต่อของคุณเพื่อระบุประเภทเชิงอรรถศาสตร์ของ ด้วย เนื่องจากจะไม่มีการใช้มูลค่าเพื่อวัตถุประสงค์อื่นใด ระบบจึงไม่ ต้องใช้ข้อมูลจริงจากแหล่งที่มาภายนอกของคุณ

มีหลายวิธีในการปรับปรุงการตรวจหาประเภทความหมายในโค้ดของคุณ ดังนี้

• แนะนำ: ส่งผ่านค่าที่กำหนดไว้ล่วงหน้า
  แสดงผลค่าที่กำหนดไว้ล่วงหน้าสำหรับแต่ละฟิลด์ที่แสดงถึงความหมายได้ดีที่สุด ประเภทของช่องและเป็นข้อมูลที่ว่า Looker Studio ตรวจพบอย่างเหมาะสม ตัวอย่างเช่น ถ้าประเภทความหมายสำหรับช่องคือประเทศ ให้แสดงผล เช่น IT สำหรับอิตาลี ประโยชน์อีกข้อหนึ่งของวิธีนี้คือ จะเร็วกว่ามากเนื่องจากคุณไม่จําเป็นต้องส่งคำขอ HTTP ไปยัง บริการของบุคคลที่สามสำหรับข้อมูล

• ส่งคืนบันทึกเพียง n จำนวน
  หากบริการของบุคคลที่สามที่คุณดึงข้อมูลรองรับขีดจํากัดแถว เมื่อขอข้อมูล จากนั้นแสดงผลข้อมูลชุดย่อยเล็กๆ ไปยัง Looker Studio แทน ของชุดข้อมูลทั้งหมด ซึ่งจะจำกัดจำนวนข้อมูลที่คุณต้องส่งผ่านไปยัง Looker Studio สําหรับคําขอตรวจจับความหมายแต่ละรายการ

• ขอคอลัมน์ทั้งหมดและแคชการตอบกลับ
  หากเป็นไปได้ที่จะขอคอลัมน์ทั้งหมดสำหรับบริการของบุคคลที่สามจาก ที่คุณกำลังดึงข้อมูลอยู่ ในคำขอตรวจจับความหมายแรก ที่ได้รับจาก Looker Studio จะดึงข้อมูลคอลัมน์ทั้งหมดและแคชผลลัพธ์ สำหรับ คำขอการตรวจหาความหมายที่ตามมาจะดึงค่าคอลัมน์จากแคช แทนที่จะส่งคำขอ HTTP เพิ่มเติมไปยังบริการของบุคคลที่สาม

• ไม่ทำอะไรแตกต่าง
  คุณเลือกที่จะไม่ติดตั้งใช้งานที่พักที่เจาะจงสำหรับคำขอที่ ตั้งค่า sampleExtraction เป็น true การดำเนินการนี้จะทําให้การตรวจจับความหมาย กระบวนการจะช้าลงเนื่องจาก Looker Studio จะต้องดึงข้อมูลทั้งหมดสําหรับ กระบวนการตรวจจับความหมาย นอกจากนี้ ยังมีผลต่ออัตราการส่งคำขอไปยัง แหล่งข้อมูลภายนอก เนื่องจากคำขอตรวจหาความหมายจำนวนมาก ดำเนินการพร้อมกัน

รูปแบบที่รู้จักสำหรับการตรวจหาประเภทความหมายอัตโนมัติ

วันที่และเวลา

• YYYY/MM/DD-HH:MM:SS
• YYYY-MM-DD [HH:MM:SS[.uuuuuu]]
• YYYY/MM/DD [HH:MM:SS[.uuuuuu]]
• YYYYMMDD [HH:MM:SS[.uuuuuu]]
• Sat, 24 May 2008 20:09:47 GMT
• 2008-05-24T20:09:47Z
• เวลา: epoch สำหรับวินาที ไมโคร มิลลิ และนาโน

ภูมิศาสตร์

• ชื่อหรือรหัสทวีป
• ชื่อหรือรหัสทวีปย่อย
• ชื่อหรือรหัสภูมิภาค
• ชื่อหรือรหัสประเทศ และ ดู ISO_3166-1
• ชื่อเมือง
• ค่าละติจูดและลองจิจูดที่คั่นด้วยเครื่องหมายจุลภาค
• ชื่อและโค้ดพื้นที่การตลาดที่กำหนด (DMA)