Questa pagina documenta la versione 18.4.0 di AlloyDB Omni che utilizza l'opzione di deployment container. Scegli un'altra opzione di deployment.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Accedere ai dati di Apache Solr da AlloyDB Omni

Seleziona una versione della documentazione:

Puoi accedere ai dati archiviati in Apache Solr ed eseguire ricerche utilizzando l'integrazione della ricerca esterna in AlloyDB Omni. Questa integrazione ti consente di trasferire dal tuo database operativo a Solr i workload di ricerca a testo intero intensiva, analisi di query complesse e faceting avanzato, migliorando la latenza delle query e il throughput complessivo del sistema.

Prima di iniziare

Prima di iniziare, completa i seguenti passaggi:

Archivia le credenziali Solr in Secret Manager

AlloyDB Omni archivia e legge le tue credenziali Solr da Secret Manager. Per l'autenticazione HTTP di base, il valore del secret in Secret Manager deve essere una stringa con codifica base64 nel formato username:password. Per saperne di più su come utilizzare Secret Manager, consulta Crea e accedi a un secret utilizzando Secret Manager.

Assicurati che il account di servizio utilizzato da AlloyDB Omni disponga dell'autorizzazione secretmanager.secretAccessor per leggere il secret da Secret Manager. Per saperne di più, consulta Gestisci l'accesso ai secret.

Attiva e configura l'estensione `external_search_fdw`

Per avviare l'integrazione con Solr, configura l'accesso al cluster Solr tramite un server di dati esterno.

Connettiti al database e abilita l'estensione:
```
CREATE EXTENSION external_search_fdw;
```
Crea un server esterno:
```
CREATE SERVER SOLR_SERVER_NAME
FOREIGN DATA WRAPPER external_search_fdw
OPTIONS (
  server 'SOLR_SERVER_HOST_PORT',
  search_provider 'solr',
  auth_mode 'secret_manager',
  auth_method 'AUTH_METHOD',
  secret_path 'SECRET_PATH'
);
```
Sostituisci le seguenti variabili:
- SOLR_SERVER_NAME: il nome del server di dati esterno. Ad esempio, solr.
- SOLR_SERVER_HOST_PORT: URL pubblico del cluster Solr. Ad esempio, https://node1.solr.test.com:8983.
- AUTH_METHOD: il tipo di autenticazione da utilizzare. Ad esempio, Basic.
- SECRET_PATH: il percorso di Secret Manager per le tue credenziali di autenticazione Solr. Ad esempio, projects/PROJECT_ID/secrets/apikey/versions/1.

Definisci la mappatura degli utenti per il server Solr:

CREATE USER MAPPING FOR CURRENT_USER
SERVER SOLR_SERVER_NAME;

Mappa lo schema della tua raccolta Solr a una tabella esterna PostgreSQL.
```
CREATE FOREIGN TABLE SOLR_FD_TABLE(
    metadata external_search_fdw_schema.OpaqueMetadata,
    SOLR_FIELDS)
       SERVER SOLR_SERVER_NAME
       OPTIONS(
            remote_table_name 'SOLR_COLLECTION_NAME',
            unique_key_sort_suffix 'UNIQUE_KEY_SORT_SUFFIX'
);
```
Sostituisci le seguenti variabili:
- SOLR_FD_TABLE: il nome della tabella di dati esterni che rappresenta la tabella Solr. Ad esempio, my-fd-solr-table.
- SOLR_FIELDS: un elenco separato da virgole in cui ogni voce segue il formato solr_field_name PG_DATA_TYPE. Per un elenco dei tipi di dati Solr supportati e dei relativi tipi PostgreSQL, consulta Tipi di dati supportati.
- UNIQUE_KEY_SORT_SUFFIX: (facoltativo) il campo della chiave univoca in Solr o un elenco separato da virgole di più campi con i relativi ordinamenti, ad esempio myid0 ASC, myid1 DESC, utilizzato per l'impaginazione. Il valore predefinito è id.
- PG_DATA_TYPE: il tipo PostgreSQL a cui vuoi mappare il tipo di origine. Ad esempio:
  - TEXT per i dati di tipo stringa.
  - INTEGER per i dati numerici.
- SOLR_COLLECTION_NAME: il nome della tua raccolta Solr. Ad esempio, my-solr-collection.

Esegui query sui dati Solr

AlloyDB Omni converte le query SQL in query API REST Solr.

Query SQL standard

Per l'espressione di ricerca, puoi utilizzare SQL standard con la sintassi Lucene.

SELECT id, body
FROM SOLR_FD_TABLE
WHERE FILTER
ORDER BY metadata <@> 'QUERY';

Sostituisci le seguenti variabili:

SOLR_FD_TABLE: il nome della tabella di dati esterni che rappresenta la tabella Solr. Ad esempio, my-fd-solr-table.
FILTER: (facoltativo) filtro da applicare alla query Solr. Ad esempio, a = 10 AND qubits < 105.
QUERY: query da inviare a Solr. Ad esempio, body:database.

Query DSL

Per casi d'uso avanzati, come l'implementazione di query nidificate, l'ordinamento personalizzato o il filtro complesso, utilizza il DSL di query in stile JSON di Solr.

SELECT id, title
FROM SOLR_FD_TABLE
ORDER BY metadata <@> $${
  "query": "title:solr",
  "filter": ["category:software", "inStock:true"],
  "sort": "price desc"
}$$
LIMIT 1;

Sostituisci SOLR_FD_TABLE con il nome della tabella di dati esterni che rappresenta la tua tabella Solr. Ad esempio: my-fd-solr-table.

Ricerche ibride

Per eseguire una ricerca ibrida sui dati Solr, unisci i risultati della ricerca di token Solr ai risultati della ricerca vettoriale di AlloyDB Omni.

SELECT *
FROM ai.hybrid_search(
  ARRAY[
    '{"limit": LIMIT,
      "weight": WEIGHT,
      "table_name": "SOLR_FD_TABLE",
      "key_column": "id",
      "query_text_input": "QUERY"}'::jsonb
  ])
ORDER BY score DESC;