نشر موصِّل قاعدة بيانات

يمكنك إعداد 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. انسخ الملف المضغوط للموصل إلى دليل التثبيت المحلي ثم فك ضغطه:

   $ 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 مثل تهيئة البيانات الوصفية وتنسيقات التاريخ وخيارات قائمة التحكم بالوصول، انتقل إلى مَعلمات الموصِّل التي توفّرها 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

• استعلام الاجتياز الكامل الذي يطبق قوائم التحكم بالوصول الفردية مع أسماء مستعارة:

  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 > ?

• استعلام اجتياز إضافي يطبق قوائم التحكم في الوصول الفردية بأسماء مستعارة:

  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

حقول المحتوى

استخدام خيارات المحتوى لتحديد قيم السجل يجب أن يكون جزءًا من المحتوى القابل للبحث.