ทำให้เครื่องมือเชื่อมต่อฐานข้อมูลใช้งานได้

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

คุณตั้งค่า Google Cloud Search เพื่อค้นหาและจัดทำดัชนีข้อมูลจากฐานข้อมูลขององค์กรโดยใช้เครื่องมือเชื่อมต่อฐานข้อมูลของ Google Cloud Search ได้

สิ่งสำคัญที่ควรพิจารณา

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

ข้อกำหนดของระบบ

ข้อกำหนดของระบบ
ระบบปฏิบัติการ Windows หรือ Linux
ฐานข้อมูล SQL ฐานข้อมูล SQL ที่มีไดรเวอร์ที่เป็นไปตามข้อกำหนด JDBC 4.0 ขึ้นไป ซึ่งรวมถึงรายการต่อไปนี้
  • เซิร์ฟเวอร์ MS SQL (2008, 2012, 2014, 2016)
  • Oracle (11 ก., 12 C)
  • Google Cloud SQL
  • MySQL
ซอฟต์แวร์ ไดรเวอร์ JDBC สำหรับเครื่องมือเชื่อมต่อที่จะใช้ในการเข้าถึงฐานข้อมูล (ดาวน์โหลดและติดตั้งแยกกัน)

ทำให้เครื่องมือเชื่อมต่อใช้งานได้

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

ข้อกำหนดเบื้องต้น

โปรดรวบรวมข้อมูลต่อไปนี้ก่อนทำให้เครื่องมือเชื่อมต่อฐานข้อมูล Cloud Search ใช้งานได้

ขั้นตอนที่ 1 ดาวน์โหลดและสร้างซอฟต์แวร์เครื่องมือเชื่อมต่อฐานข้อมูล

  1. โคลนที่เก็บเครื่องมือเชื่อมต่อจาก GitHub
    $ git clone https://github.com/google-cloudsearch/database-connector.git
    $ cd database-connector
  2. ตรวจสอบเครื่องมือเชื่อมต่อเวอร์ชันที่ต้องการ:
    $ git checkout tags/v1-0.0.3
  3. สร้างเครื่องมือเชื่อมต่อ
    $ mvn package
    หากต้องการข้ามการทดสอบเมื่อสร้างเครื่องมือเชื่อมต่อ ให้ใช้ mvn package -DskipTests
  4. คัดลอกไฟล์ ZIP ของเครื่องมือเชื่อมต่อไปยังไดเรกทอรีการติดตั้งในเครื่องและแตกไฟล์ ZIP:
    $ cp target/google-cloudsearch-database-connector-v1-0.0.3.zip installation-dir
    $ cd installation-dir
    $ unzip google-cloudsearch-database-connector-v1-0.0.3.zip
    $ cd google-cloudsearch-database-connector-v1-0.0.3

ขั้นตอนที่ 2 กำหนดค่าเครื่องมือเชื่อมต่อฐานข้อมูล

  1. สร้างไฟล์ข้อความและตั้งชื่อเป็น connector-config.properties (ค่าเริ่มต้น) หรือที่คล้ายกัน Google ขอแนะนำให้คุณตั้งชื่อไฟล์การกำหนดค่าด้วยส่วนขยาย .properties หรือ .config และเก็บไฟล์ไว้ในไดเรกทอรีเดียวกับเครื่องมือเชื่อมต่อ หากใช้ชื่อหรือเส้นทางอื่น คุณต้องระบุเส้นทางเมื่อเรียกใช้เครื่องมือเชื่อมต่อ
  2. เพิ่มพารามิเตอร์เป็นคู่คีย์/ค่าลงในเนื้อหาไฟล์ ไฟล์การกำหนดค่าต้องระบุพารามิเตอร์สำหรับการเข้าถึงแหล่งข้อมูล, การเข้าถึงฐานข้อมูล, คำสั่ง SQL การส่งผ่านฐานข้อมูลแบบสมบูรณ์ ชื่อฟิลด์เนื้อหา และการกำหนดคอลัมน์ นอกจากนี้ คุณยังกำหนดค่าลักษณะการทำงานอื่นๆ ของเครื่องมือเชื่อมต่อด้วยพารามิเตอร์ที่ไม่บังคับได้อีกด้วย เช่น
    # Required parameters for data source access
    api.sourceId=1234567890abcdef
    api.identitySourceId=0987654321lmnopq
    api.serviceAccountPrivateKeyFile=./PrivateKey.json
    #
    # Required parameters for database access
    db.url=jdbc:mysql://localhost:3306/mysql_test
    db.user=root
    db.password=passw0rd
    #
    # Required full traversal SQL statement parameter
    db.allRecordsSql=select customer_id, first_name, last_name, phone, change_timestamp from address_book
    #
    # Required parameters for column definitions and URL format
    db.allColumns=customer_id, first_name, last_name, phone, change_timestamp
    db.uniqueKeyColumns=customer_id
    url.columns=customer_id
    #
    # Required content field parameter
    contentTemplate.db.title=customer_id
    #
    # Optional parameters to set ACLs to "entire domain" access
    defaultAcl.mode=fallback
    defaultAcl.public=true
    #
    # Optional parameters for schedule traversals
    schedule.traversalIntervalSecs=36000
    schedule.performTraversalOnStart=true
    schedule.incrementalTraversalIntervalSecs=3600
    

    หากต้องการคำอธิบายโดยละเอียดเกี่ยวกับพารามิเตอร์เฉพาะฐานข้อมูล ให้ไปที่ ข้อมูลอ้างอิงพารามิเตอร์การกำหนดค่าท้ายบทความนี้

    หากต้องการดูข้อมูลเกี่ยวกับพารามิเตอร์ที่ใช้กับเครื่องมือเชื่อมต่อ Cloud Search ทั้งหมด เช่น การกำหนดค่าข้อมูลเมตา รูปแบบวันที่และเวลา และตัวเลือก ACL โปรดไปที่ พารามิเตอร์เครื่องมือเชื่อมต่อที่ Google จัดหา

    โปรดระบุพร็อพเพอร์ตี้ของออบเจ็กต์สคีมาในพารามิเตอร์การค้นหาของ SQL การข้ามผ่าน (หากมี) โดยปกติแล้ว คุณสามารถเพิ่มชื่อแทนในคำสั่ง SQL ได้ เช่น หากคุณมีฐานข้อมูลภาพยนตร์และสคีมาแหล่งข้อมูลมีคำจำกัดความของพร็อพเพอร์ตี้ที่ชื่อ "ActorName" คำสั่ง SQL อาจมีรูปแบบเป็น SELECT …, last_name AS ActorName, … FROM …

ขั้นตอนที่ 3 เรียกใช้เครื่องมือเชื่อมต่อฐานข้อมูล

ตัวอย่างต่อไปนี้จะถือว่าคอมโพเนนต์ที่จำเป็นอยู่ในไดเรกทอรีภายในของระบบ Linux

หากต้องการเรียกใช้เครื่องมือเชื่อมต่อจากบรรทัดคำสั่ง ให้ป้อนคำสั่งต่อไปนี้

java \
   -cp "google-cloudsearch-database-connector-v1-0.0.3.jar:mysql-connector-java-5.1.41-bin.jar" \
   com.google.enterprise.cloudsearch.database.DatabaseFullTraversalConnector \
   [-Dconfig=mysql.config]

โดยที่

  • google-cloud-search-database-connector-v1-0.0.3.jar คือไฟล์ .jar ของเครื่องมือเชื่อมต่อฐานข้อมูล
  • mysql-connector-java-5.1.41-bin.jar เป็นไดรเวอร์ JDBC ที่ใช้เพื่อเข้าถึงฐานข้อมูล
  • mysql.config คือไฟล์การกำหนดค่าที่มีชื่อที่กำหนดเอง ระบุเส้นทางในบรรทัดคำสั่งเพื่อให้เครื่องมือเชื่อมต่อจดจำไฟล์การกำหนดค่า ไม่เช่นนั้นเครื่องมือเชื่อมต่อจะใช้ connector-config.properties ในไดเรกทอรีภายในเป็นชื่อไฟล์เริ่มต้น

เครื่องมือเชื่อมต่อจะรายงานข้อผิดพลาดในการกำหนดค่าตามที่ตรวจพบ ระบบจะรายงานข้อผิดพลาดบางอย่างเมื่อเครื่องมือเชื่อมต่อเริ่มต้น เช่น เมื่อมีการกำหนดคอลัมน์ฐานข้อมูลให้เป็นส่วนหนึ่งของเนื้อหาของระเบียน (ใน db.allColumns) แต่จะไม่มีการใช้คอลัมน์ในการค้นหา SQL แบบข้ามผ่านของฐานข้อมูล (ใน db.allRecordsSql) ระบบจะตรวจพบและรายงานข้อผิดพลาดอื่นๆ เฉพาะเมื่อเครื่องมือเชื่อมต่อพยายามเข้าถึงฐานข้อมูลสำหรับการข้ามผ่านครั้งแรก เช่น ไวยากรณ์คำสั่ง SQL ที่ไม่ถูกต้อง

การอ้างอิงพารามิเตอร์การกําหนดค่า

พารามิเตอร์การเข้าถึงแหล่งข้อมูล

การเกริ่นนำ พารามิเตอร์
รหัสแหล่งข้อมูล api.sourceId = source-ID

ต้องระบุ รหัสแหล่งที่มา Cloud Search ที่ผู้ดูแลระบบ Google Workspace ตั้งค่า

รหัสแหล่งที่มาของข้อมูลประจำตัว api.identitySourceId = identity-source-ID

ต้องใช้ผู้ใช้และกลุ่มภายนอกสำหรับ ACL รหัสแหล่งที่มาของข้อมูลประจำตัว Cloud Search ที่ผู้ดูแลระบบ Google Workspace ตั้งค่า

บัญชีบริการ api.serviceAccountPrivateKeyFile = path-to-private-key

ต้องระบุ เส้นทางไปยังไฟล์คีย์บัญชีบริการ Cloud Search ที่ผู้ดูแลระบบ Google Workspace สร้างขึ้น

พารามิเตอร์การเข้าถึงฐานข้อมูล

การเกริ่นนำ พารามิเตอร์
URL ฐานข้อมูล db.url = database-URL

ต้องระบุ เส้นทางแบบเต็มของฐานข้อมูลที่จะเข้าถึง เช่น jdbc:mysql://127.0.0.1/dbname

ชื่อผู้ใช้และรหัสผ่านฐานข้อมูล db.user = username
db.password = password

ต้องระบุ ชื่อผู้ใช้และรหัสผ่านที่ถูกต้องซึ่งเครื่องมือเชื่อมต่อใช้ในการเข้าถึงฐานข้อมูล ผู้ใช้ฐานข้อมูลนี้ต้องมีสิทธิ์อ่านบันทึกที่เกี่ยวข้องของฐานข้อมูลที่อ่านอยู่

ไดรเวอร์ JDBC db.driverClass = oracle.jdbc.OracleDriver

จำเป็นเฉพาะในกรณีที่ไม่มีการระบุไดรเวอร์ JDBC 4.0 ในเส้นทางคลาสเท่านั้น

พารามิเตอร์การค้นหา SQL แบบข้ามผ่าน

เครื่องมือเชื่อมต่อจะข้ามผ่านบันทึกฐานข้อมูลด้วยการค้นหา SQL SELECT ในไฟล์การกำหนดค่า คุณต้องกำหนดค่า Query การข้ามผ่านเต็มรูปแบบ โดยที่การค้นหาสำหรับการข้ามผ่านส่วนเพิ่มเป็นแบบไม่บังคับ

การส่งผ่านแบบเต็มรูปแบบจะอ่านบันทึกฐานข้อมูลทั้งหมดที่กำหนดค่าไว้สำหรับการจัดทำดัชนี คุณต้องใช้การส่งผ่านอย่างเต็มรูปแบบเพื่อจัดทำดัชนีระเบียนใหม่สำหรับ Cloud Search และเพื่อจัดทำดัชนีระเบียนที่มีอยู่ทั้งหมดอีกครั้ง

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

เครื่องมือเชื่อมต่อจะดำเนินการข้ามผ่านเหล่านี้ตามกำหนดการที่คุณกำหนดใน พารามิเตอร์กำหนดการข้ามผ่าน

การเกริ่นนำ พารามิเตอร์
ข้อความค้นหาการข้ามผ่านเต็มรูปแบบ db.allRecordsSql = SELECT column-1[, column-2,...] FROM database-name

ต้องระบุ ระบบจะเรียกใช้การค้นหาสำหรับการส่งผ่านทั้งหมด

ทุกชื่อคอลัมน์ที่เครื่องมือเชื่อมต่อจะใช้ในความจุใดก็ได้ (เนื้อหา, รหัสที่ไม่ซ้ำกัน, ACL) ต้องมีอยู่ในคำค้นหานี้ เครื่องมือเชื่อมต่อจะดำเนินการยืนยันเบื้องต้นบางอย่างเมื่อเริ่มต้นใช้งานเพื่อตรวจหาข้อผิดพลาดและการละเว้น ด้วยเหตุนี้ จึงอย่าใช้คำค้นหา "SELECT * FROM ..." ทั่วไป

การใส่เลขหน้าข้ามผ่านแบบเต็ม db.allRecordsSql.pagination = {none | offset}

ค่าที่จะปรากฏได้แก่

  • ไม่มี: ไม่ใช้การใส่เลขหน้า
  • offset: ใช้การใส่เลขหน้าตามออฟเซ็ตแถว

    หากต้องการใช้การใส่เลขหน้าตามออฟเซ็ต การค้นหา SQL ต้องมีเครื่องหมายคำถามตัวยึดตำแหน่ง (?) สำหรับออฟเซ็ตแถวที่เริ่มต้นด้วย 0 ในการข้ามผ่านทั้งหมดแต่ละครั้ง ระบบจะดำเนินการค้นหาซ้ำจนกว่าจะไม่มีผลลัพธ์

ข้อความค้นหาการข้ามผ่านที่เพิ่มขึ้น db.incrementalUpdateSql = SELECT column-1[, column-2,...] FROM database-name WHERE last_update_time > ?

ต้องระบุหากคุณกำหนดเวลาการข้ามผ่านที่เพิ่มขึ้น

"?" ในการค้นหาเป็นตัวยึดตำแหน่งที่จำเป็นสำหรับค่าการประทับเวลา เครื่องมือเชื่อมต่อจะใช้การประทับเวลาเพื่อติดตามการแก้ไขระหว่างการค้นหา SQL แบบข้ามผ่านที่เพิ่มขึ้น

หากต้องการติดตามคอลัมน์การประทับเวลาของฐานข้อมูลสำหรับเวลาที่อัปเดตครั้งล่าสุด ให้เพิ่มชื่อแทน timestamp_column ในคำสั่ง SQL มิเช่นนั้น ให้ใช้การประทับเวลาปัจจุบันของการข้ามผ่านของเครื่องมือเชื่อมต่อ

สำหรับการข้ามผ่านที่เพิ่มขึ้นครั้งแรก ตัวเชื่อมต่อจะใช้เวลาเริ่มต้นของตัวเชื่อมต่อ หลังจากการข้ามผ่านที่เพิ่มขึ้นครั้งแรก Cloud Search จะจัดเก็บการประทับเวลาเพื่อให้เครื่องมือเชื่อมต่อรีสตาร์ทเข้าถึงการประทับเวลาการข้ามผ่านที่เพิ่มขึ้นก่อนหน้านี้ได้

เขตเวลาของฐานข้อมูล db.timestamp.timezone = America/Los_Angeles

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

ตัวอย่างการค้นหา SQL แบบข้ามผ่าน

  • การค้นหาการข้ามผ่านเต็มรูปแบบพื้นฐานที่อ่านบันทึกทั้งหมดที่สนใจในฐานข้อมูลพนักงานเพื่อการจัดทำดัชนี:
    db.allRecordsSql = SELECT customer_id, first_name, last_name, employee_id, interesting_field \
        FROM employee
  • ระบุการใส่เลขหน้าตามออฟเซ็ต และแยกการส่งผ่านทั้งหมดเป็นข้อความค้นหาหลายรายการ

    สำหรับ SQL Server 2012 หรือ Oracle 12c (ไวยากรณ์ SQL 2008 มาตรฐาน):

    db.allRecordsSql = SELECT customer_id, first_name, last_name, employee_id, interesting_field \
        FROM employee \
        ORDER BY customer_id OFFSET ? ROWS FETCH FIRST 1000 ROWS ONLY
    db.allRecordsSql.pagination = offset
    

    หรือสำหรับ MySQL หรือ Google Cloud SQL ให้ทำดังนี้

    db.allRecordsSql = SELECT customer_id, first_name, last_name, employee_id, interesting_field \
        FROM employee \
        ORDER BY customer_id LIMIT 1000 OFFSET ?
    db.allRecordsSql.pagination = offset
  • การค้นหาการข้ามผ่านเต็มรูปแบบที่ใช้ ACL แต่ละรายการกับชื่อแทน:
    db.allRecordsSql = SELECT customer_id, first_name, last_name,  employee_id, interesting_field, last_update_time, \
         permitted_readers AS readers_users, \
         denied_readers AS denied_users, \
         permitted_groups AS readers_groups, \
         denied_groups AS denied_groups \
         FROM employee
  • การค้นหาการข้ามผ่านเพิ่มเติมพื้นฐาน:
    db.incrementalUpdateSql = SELECT customer_id, first_name, last_name, employee_id, interesting_field, last_update_time \
         FROM employee \
         WHERE last_update_time > ?
  • การค้นหาการข้ามผ่านที่เพิ่มขึ้นที่ใช้ ACL แต่ละรายการกับชื่อแทน:
    db.incrementalUpdateSql = SELECT customer_id, first_name, last_name, employee_id, interesting_field, last_update_time, \
         permitted_readers AS readers_users, \
         denied_readers AS denied_users, \
         permitted_groups AS readers_groups, \
         denied_groups AS denied_groups \
         FROM employee \
         WHERE last_update_time > ?
  • การค้นหาการข้ามผ่านที่เพิ่มขึ้นที่ใช้การประทับเวลาของฐานข้อมูล แทนเวลาปัจจุบัน:
    db.incrementalUpdateSql = SELECT customer_id, first_name, last_name, employee_id, interesting_field, \
         last_update_time AS timestamp_column \
         FROM employee \
         WHERE last_update_time > ?

พารามิเตอร์คำจำกัดความคอลัมน์

พารามิเตอร์ต่อไปนี้ระบุคอลัมน์ที่คุณใช้ในคำสั่งการข้ามผ่านและเพื่อระบุระเบียนแต่ละรายการโดยไม่ซ้ำกัน

การเกริ่นนำ พารามิเตอร์
คอลัมน์ทั้งหมด db.allColumns = column-1, column-2, ...column-N

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

ตัวอย่าง

db.allColumns = customer_id, first_name, last_name, phone, change_timestamp
คอลัมน์คีย์ที่ไม่ซ้ำกัน db.uniqueKeyColumns = column-1[, column-2]

ต้องระบุ แสดงรายการคอลัมน์ฐานข้อมูลเดียวที่มีค่าที่ไม่ซ้ำกัน หรือปรากฏร่วมกับคอลัมน์ซึ่งมีค่าที่ระบุรหัสที่ไม่ซ้ำ

Cloud Search กำหนดให้เอกสารที่ค้นหาได้ทุกรายการต้องมีตัวระบุที่ไม่ซ้ำกันภายในแหล่งข้อมูล คุณต้องกำหนดรหัสที่ไม่ซ้ำกันสำหรับระเบียนฐานข้อมูลแต่ละรายการจากค่าคอลัมน์ได้ หากคุณเรียกใช้เครื่องมือเชื่อมต่อหลายรายการในฐานข้อมูลที่แยกกัน แต่จัดทำดัชนีไว้ในชุดข้อมูลทั่วไป โปรดตรวจสอบว่าคุณระบุรหัสที่ไม่ซ้ำกันในเอกสารทั้งหมด

ตัวอย่าง

db.uniqueKeyColumns = customer_id
# or
db.uniqueKeyColumns = last_name, first_name
คอลัมน์ลิงก์ URL url.columns = column-1[, column-2]

ต้องระบุ ระบุชื่อที่กำหนดไว้และที่ถูกต้องอย่างน้อย 1 ชื่อของคอลัมน์ที่ใช้สำหรับ URL ที่ใช้สำหรับผลการค้นหาที่คลิกได้ สำหรับฐานข้อมูลที่ไม่มี URL ที่เกี่ยวข้องซึ่งเชื่อมโยงกับระเบียนฐานข้อมูลแต่ละรายการ คุณจะใช้ลิงก์แบบคงที่สำหรับทุกระเบียนได้

อย่างไรก็ตาม หากค่าคอลัมน์กำหนดลิงก์ที่ถูกต้องสำหรับแต่ละระเบียน ควรระบุคอลัมน์ URL การดูและค่าของการกำหนดค่ารูปแบบ

รูปแบบ URL url.format = https://www.example.com/{0}

กำหนดรูปแบบของ URL ข้อมูลพร็อพเพอร์ตี้ พารามิเตอร์ที่มีลำดับเลขหมายถึงคอลัมน์ที่ระบุใน db.columns ตามลำดับโดยเริ่มจาก 0

หากไม่ได้ระบุไว้ ค่าเริ่มต้นจะเป็น "{0}"

ตัวอย่างเป็นไปตามตารางนี้

คอลัมน์ที่เข้ารหัสแบบเปอร์เซ็นต์สำหรับ URL url.columnsToEscape = column-1[, column-2]

ระบุคอลัมน์จาก db.columns ที่จะเข้ารหัสแบบเปอร์เซ็นต์ก่อนที่จะรวมไว้ในสตริง URL ที่จัดรูปแบบ

ตัวอย่างคอลัมน์ URL

หากต้องการระบุคอลัมน์ที่ใช้ในคำค้นหาข้ามผ่านและรูปแบบของ URL มุมมอง ให้ทำดังนี้

  • หากต้องการใช้ URL แบบคงที่โดยไม่ใช้ค่าระเบียนฐานข้อมูล ให้ทำดังนี้
    url.format = https://www.example.com
  • หากต้องการใช้ค่าคอลัมน์เดียวที่เป็น URL ข้อมูลพร็อพเพอร์ตี้ ให้ทำดังนี้
    url.format = {0}
    url.columns = customer_id
  • หากต้องการใช้ค่าคอลัมน์เดียวที่แทนลงใน URL ข้อมูลพร็อพเพอร์ตี้ที่ตำแหน่ง {0} ให้ทำดังนี้
    url.format = https://www.example.com/customer/id={0}
    url.columns = customer_id
    url.columnsToEscape = customer_id
  • หากต้องการใช้ค่าหลายคอลัมน์เพื่อสร้าง URL ข้อมูลพร็อพเพอร์ตี้ (คอลัมน์ต่างๆ จะขึ้นอยู่กับลำดับ) ให้ทำดังนี้
    url.format = {1}/customer={0}
    url.columns = customer_id, linked_url
    url.columnsToEscape = customer_id

ช่องเนื้อหา

ใช้ตัวเลือกเนื้อหาเพื่อกำหนดค่าระเบียนที่ควรเป็นส่วนหนึ่งของเนื้อหาที่ค้นหาได้

การเกริ่นนำ พารามิเตอร์
คอลัมน์การค้นหาคุณภาพสูงสุด contentTemplate.db.title = column-name

ต้องระบุ คอลัมน์คุณภาพสูงสุดสำหรับการจัดทำดัชนีการค้นหาและการจัดลำดับความสำคัญของผลการค้นหา

ลำดับความสำคัญของคอลัมน์สำหรับการค้นหา contentTemplate.db.quality.high = column-1[, column-2...]
contentTemplate.db.quality.medium = column-1[, column-2...]
contentTemplate.db.quality.low = column-1[, column-2...]

กำหนดคอลัมน์เนื้อหา (ยกเว้นชุดคอลัมน์สำหรับ contentTemplate.db.title) เป็นช่องคุณภาพสูง ปานกลาง หรือต่ำ คอลัมน์ที่ไม่ระบุจะมีค่าเริ่มต้นเป็นต่ำ

คอลัมน์ข้อมูลเนื้อหา db.contentColumns = column-1[, column-2...]

ระบุคอลัมน์เนื้อหาในฐานข้อมูล ระบบจะจัดรูปแบบข้อมูลเหล่านี้และอัปโหลดไปยัง Cloud Search เป็นเนื้อหาเอกสารที่ค้นหาได้

หากไม่ได้ระบุค่า ค่าเริ่มต้นคือ "*" ซึ่งบ่งบอกว่าควรใช้คอลัมน์ทั้งหมดสำหรับเนื้อหา

คอลัมน์ BLOB db.blobColumn = column-name

ระบุชื่อของคอลัมน์ BLOB เดียวเพื่อใช้สำหรับเนื้อหาเอกสารแทนชุดค่าผสมของคอลัมน์เนื้อหา

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