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

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

• คีย์ส่วนตัวของ Google Workspace ซึ่งมีรหัสบัญชีบริการด้วย หากต้องการดูวิธีรับคีย์ส่วนตัว โปรดไปที่ กำหนดค่าการเข้าถึง Google Cloud ค้นหา REST API
• รหัสแหล่งข้อมูล Google Workspace หากต้องการดูวิธีรับรหัสแหล่งข้อมูล ให้ไปที่ เพิ่มแหล่งข้อมูลเพื่อค้นหา

ขั้นตอนที่ 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

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 ที่ไม่ถูกต้อง

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

ตัวอย่างการค้นหา 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 = customer_id, first_name, last_name, phone, change_timestamp

db.uniqueKeyColumns = customer_id
# or
db.uniqueKeyColumns = last_name, first_name

ตัวอย่างคอลัมน์ 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

ฟิลด์เนื้อหา

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