Veritabanı bağlayıcısı dağıtma

Kuruluşunuzun bilgilerindeki verileri keşfedip dizine eklemek için Google Cloud Search'ü Google Cloud Search veritabanı bağlayıcısını kullanarak veri tabanlarını yeniden düzenleyebilirsiniz.

• Hizmet hesabı kimliğini de içeren Google Workspace özel anahtarı. Özel anahtarı nasıl alacağınızı öğrenmek için şu adrese gidin: Google Cloud'a erişimi yapılandırma Arama REST API.
• Google Workspace veri kaynağı kimliği. Veri kaynağı kimliğini nasıl alacağınızı öğrenmek için şu sayfaya gidin: Arama yapmak için bir veri kaynağı ekleyin.

1. Adım: Veritabanı bağlayıcı yazılımını indirin ve derleyin

1. GitHub'dan bağlayıcı deposunu klonlayın.

   $ git clone https://github.com/google-cloudsearch/database-connector.git
   $ cd database-connector

2. İstediğiniz bağlayıcı sürümü olup olmadığını kontrol edin:
   

   $ git checkout tags/v1-0.0.3

3. Bağlayıcıyı oluşturun.

   $ mvn package

   Bağlayıcıyı oluştururken testleri atlamak için mvn package -DskipTests işlevini kullanın.
4. Bağlayıcı zip dosyasını yerel yükleme dizininize kopyalayın ve sıkıştırılmış dosyayı açın:

   $ 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. Bir metin dosyası oluşturun ve dosyayı connector-config.properties (varsayılan) veya benzeri bir adla adlandırın. Google'ın önerisi yapılandırma dosyalarına .properties veya .config uzantısını ekleyin ve dosyayı bağlayıcıyla aynı dizinde tutun. Farklı bir ad veya yol kullanırsanız bağlayıcıyı çalıştırırken yolu belirtmeniz gerekir.
2. Parametreleri, dosya içeriğine anahtar/değer çiftleri olarak ekleyin. Yapılandırma dosyası şunu belirtmelidir: veri kaynağı erişimi, veritabanı erişimi, veritabanı tam geçişi SQL ifadesi, içerik alanı başlığı ve sütun tanımları. Diğer bağlayıcı davranışlarını da yapılandırabilirsiniz. parametresini kullanabilirsiniz. Örneğin:

   # 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
   

   Veritabanına özgü parametrelerin ayrıntılı açıklamaları için Bu makalenin sonundaki Yapılandırma parametreleri referansı.

   Tüm Cloud Search'te ortak olan parametreler hakkında bilgi edinmek için bağlayıcıları (ör. meta veri yapılandırması, tarih ve saat biçimleri ve EKL seçenekleri) Google tarafından sağlanan bağlayıcı parametreleri.

   Mümkünse geçiş SQL'inde şema nesnesinin özelliklerini belirtin. sorgu parametreleridir. Genellikle SQL'e takma adlar ekleyebilirsiniz. ifade eder. Örneğin, bir film veri kaynağı şeması, adlı bir mülk tanımını "ActorName", bir SQL ifadesi şu biçimde olabilir: SELECT …, last_name AS ActorName, … FROM … .

3. Adım: Veritabanı bağlayıcısını çalıştırma

Aşağıdaki örnekte, gerekli bileşenlerin yerel dizini olur.

Bağlayıcıyı komut satırından çalıştırmak için aşağıdaki komutu girin:

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]

Burada:

• google-cloud-search-database-connector-v1-0.0.3.jar veritabanı bağlayıcısı .jar dosyası
• mysql-connector-java-5.1.41-bin.jar, kullanılan JDBC sürücüsü (veri tabanına erişmek için)
• mysql.config, özel olarak adlandırılmış bir yapılandırma dosyasıdır. Bağlayıcının yapılandırma dosyasını yüklemek için komut satırındaki yolunu belirtin. Aksi halde, bağlayıcı Yerel para biriminizde connector-config.properties dizinini varsayılan dosya adı olarak ayarlar.

Bağlayıcı, yapılandırma hatalarını algıladığında bunları bildirir. Bazı hatalar aşağıdaki durumlarda bildirilir bağlayıcı başlatılırken (örneğin, bir veritabanı sütunu kayıt içeriğinin bir parçası olarak tanımlandığında) (db.allColumns içinde), ancak sütun veritabanı (db.allRecordsSql içinde). Diğer hatalar yalnızca şu durumlarda tespit edilir ve bildirilir: bağlayıcı, geçersiz SQL ifadesi söz dizimi gibi ilk geçiş için veritabanına erişmeye çalışır.

Bağlayıcı, bu geçişleri geçiş zamanlaması parametrelerine dikkat edin.

Geçiş SQL sorgu örnekleri

• Dizine eklemek üzere çalışan veritabanındaki her önemli kaydı okuyan temel tam geçiş sorgusu:

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

• Ofsete göre sayfalandırmayı belirtin ve bir tam geçişi birden fazla sorguya ayırın.

  SQL Server 2012 veya Oracle 12c için (standart SQL 2008 söz dizimi):

  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
  

  veya MySQL ya da Google Cloud SQL için:

  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

• Takma adlarla EKL'leri tek tek uygulayan tam geçiş sorgusu:

  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

• Temel artımlı geçiş sorgusu:

  db.incrementalUpdateSql = SELECT customer_id, first_name, last_name, employee_id, interesting_field, last_update_time \
       FROM employee \
       WHERE last_update_time > ?

• Takma adlarla ayrı EKL'leri uygulayan artımlı geçiş sorgusu:

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

• Geçerli zaman yerine veritabanı zaman damgasını kullanan artımlı geçiş sorgusu:

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

Sütun tanımı parametreleri

Aşağıdaki parametreler, geçiş ifadelerinde kullandığınız sütunları belirtir ve benzersiz bir şekilde tanımlar.

db.allColumns = customer_id, first_name, last_name, phone, change_timestamp

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

URL sütunu örnekleri

Geçiş sorgularında kullanılan sütunları ve görüntüleme URL'sinin biçimini belirtmek için:

• Herhangi bir veritabanı kaydı değeri kullanmadan statik URL kullanmak için:

  url.format = https://www.example.com

• Görüntüleme URL'si olan tek bir sütun değeri kullanmak için:

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

• {0} konumundaki görüntüleme URL'siyle değiştirilecek tek bir sütun değeri kullanmak için:

  url.format = https://www.example.com/customer/id={0}
  url.columns = customer_id
  url.columnsToEscape = customer_id

• Görüntüleme URL'sini oluşturmak üzere birden çok sütun değeri kullanmak için (sütunlar sıraya bağlıdır):

  url.format = {1}/customer={0}
  url.columns = customer_id, linked_url
  url.columnsToEscape = customer_id

İçerik alanları

Hangi kayıt değerlerini tanımlamak için içerik seçeneklerini kullanın aranabilir içeriğin bir parçası haline getirilmelidir.