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

คำเตือน: เครื่องมือเชื่อมต่ออ้างอิงของ Cloud Search มีให้ "ตามที่เป็น" เป็นโค้ดตัวอย่าง เพื่อใช้สร้างเครื่องมือเชื่อมต่อที่ใช้งานได้ของคุณเอง โค้ดตัวอย่างนี้ต้องใช้ การปรับแต่งและการทดสอบที่สำคัญก่อนนำไปใช้ในการพิสูจน์แนวคิด หรือ สภาพแวดล้อมการใช้งานจริง สำหรับการใช้งานจริง เราขอแนะนำให้ขอความช่วยเหลือ จากพาร์ทเนอร์ Cloud Search ของเรา สำหรับความช่วยเหลือเพิ่มเติมในการค้นหาระบบคลาวด์ที่เหมาะสม โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าของ Google ที่ดูแลพาร์ทเนอร์ 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 ก., 12c)
  • SQL Google Cloud
  • 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 ของเครื่องมือเชื่อมต่อไปยังไดเรกทอรีการติดตั้งในเครื่อง และแตกไฟล์ดังนี้
    $ 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 การค้นหาในไฟล์การกำหนดค่า คุณต้องกำหนดค่าการค้นหาการส่งผ่านแบบสมบูรณ์ ข้อความค้นหาสำหรับ การส่งผ่านส่วนเพิ่มเป็นตัวเลือกที่ไม่บังคับ

การส่งผ่านแบบสมบูรณ์จะอ่านระเบียนฐานข้อมูลทั้งหมดที่กำหนดค่าไว้สำหรับการจัดทำดัชนี เต็ม จำเป็นต้องมีการส่งผ่านเพื่อจัดทำดัชนีระเบียนใหม่สำหรับ 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 > ?

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

อักขระ "?" ในคำค้นหาเป็นตัวยึดตําแหน่งที่จําเป็นสําหรับค่าการประทับเวลา Connector จะใช้การประทับเวลาเพื่อติดตามการแก้ไขระหว่างการค้นหา 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 ได้