একটি ডাটাবেস সংযোগকারী স্থাপন করুন

আপনি Google ক্লাউড অনুসন্ধান ডাটাবেস সংযোগকারী ব্যবহার করে আপনার প্রতিষ্ঠানের ডেটাবেস থেকে ডেটা আবিষ্কার এবং সূচী করতে Google ক্লাউড অনুসন্ধান সেট আপ করতে পারেন৷

• Google Workspace ব্যক্তিগত কী, যেটিতে পরিষেবা অ্যাকাউন্ট আইডিও রয়েছে। কীভাবে একটি ব্যক্তিগত কী পেতে হয় তা জানতে, Google ক্লাউড অনুসন্ধান 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
   

   ডাটাবেস-নির্দিষ্ট প্যারামিটারের বিশদ বিবরণের জন্য, এই নিবন্ধের শেষে কনফিগারেশন পরামিতি রেফারেন্সে যান।

   মেটাডেটা কনফিগারেশন, ডেটটাইম ফর্ম্যাট এবং 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
অ্যাক্সেস করতে ব্যবহার করা হচ্ছে
• mysql.config একটি কাস্টম-নামযুক্ত কনফিগারেশন ফাইল। সংযোগকারী আপনার কনফিগারেশন ফাইলকে চিনতে পারে তা নিশ্চিত করতে, কমান্ড লাইনে এর পাথ নির্দিষ্ট করুন। অন্যথায়, সংযোগকারী ডিফল্ট ফাইলের নাম হিসাবে আপনার স্থানীয় ডিরেক্টরিতে connector-config.properties ব্যবহার করে।

সংযোগকারী কনফিগারেশন ত্রুটির রিপোর্ট করে কারণ এটি তাদের সনাক্ত করে। কিছু ত্রুটি রিপোর্ট করা হয় যখন সংযোগকারী শুরু হয়, যেমন যখন একটি ডাটাবেস কলাম রেকর্ড বিষয়বস্তুর অংশ হিসাবে সংজ্ঞায়িত করা হয় ( db.allColumns এ), কিন্তু কলামটি ডাটাবেসের ট্রাভার্সাল SQL ক্যোয়ারীতে ব্যবহার করা হয় না ( db.allRecordsSql এ ) অন্যান্য ত্রুটি শুধুমাত্র সনাক্ত করা হয় এবং রিপোর্ট করা হয় যখন সংযোগকারী প্রথম ট্রাভার্সালের জন্য ডাটাবেস অ্যাক্সেস করার চেষ্টা করে, যেমন অবৈধ SQL স্টেটমেন্ট সিনট্যাক্স।

কানেক্টর এই ট্রাভার্সালগুলি সম্পাদন করে আপনার ট্রাভার্সাল শিডিউল প্যারামিটারে নির্ধারিত সময়সূচী অনুসারে।

ট্রাভার্সাল এসকিউএল ক্যোয়ারী উদাহরণ

• বেসিক সম্পূর্ণ ট্রাভার্সাল ক্যোয়ারী যা ইন্ডেক্সিংয়ের জন্য একজন কর্মচারী ডাটাবেসের আগ্রহের প্রতিটি রেকর্ড পড়ে:

  db.allRecordsSql = SELECT customer_id, first_name, last_name, employee_id, interesting_field \
      FROM employee

• অফসেট দ্বারা পেজিনেশন নির্দিষ্ট করুন, এবং একাধিক প্রশ্নের মধ্যে একটি সম্পূর্ণ ট্রাভার্সাল বিভক্ত করুন।

  SQL সার্ভার 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

• সম্পূর্ণ ট্রাভার্সাল ক্যোয়ারী যা উপনাম সহ পৃথক ACLs প্রয়োগ করে:

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

• ক্রমবর্ধমান ট্রাভার্সাল ক্যোয়ারী যা উপনাম সহ পৃথক ACLs প্রয়োগ করে:

  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.format = https://www.example.com

• একটি একক কলাম মান ব্যবহার করতে যা ভিউ URL:

  url.format = {0}
  url.columns = customer_id

• অবস্থান {0}-এ ভিউ URL-এ প্রতিস্থাপিত একটি একক কলাম মান ব্যবহার করতে:

  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

বিষয়বস্তু ক্ষেত্রগুলি

অনুসন্ধানযোগ্য সামগ্রীর কোন রেকর্ড মানগুলিকে অংশ করা উচিত তা নির্ধারণ করতে সামগ্রী বিকল্পগুলি ব্যবহার করুন৷