Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Amazon RDS (Microsoft SQL Server)
SQL Server è un sistema di gestione di database sviluppato da Microsoft. Amazon RDS per SQL Server semplifica la configurazione, il funzionamento e la scalabilità delle distribuzioni di SQL Server nel cloud. Se sei un utente Amazon RDS (Microsoft SQL Server), puoi utilizzarlo Amazon Kendra per indicizzare la tua origine dati Amazon RDS (Microsoft SQL Server). Il connettore di origine dati Amazon Kendra JDBC supporta Microsoft SQL Server 2019.
Puoi connetterti Amazon Kendra alla tua origine dati Amazon RDS (Microsoft SQL Server) utilizzando la Amazon Kendra console e l'TemplateConfigurationAPI.
Per la risoluzione dei problemi relativi al connettore di origine dati Amazon Kendra Amazon RDS (Microsoft SQL Server), vedereRisoluzione dei problemi relativi alle origini dati.
Funzionalità supportate
-
Mappature dei campi
-
Filtraggio del contesto utente
-
Filtri di inclusione/esclusione
-
Sincronizzazione completa e incrementale dei contenuti
-
Virtual Private Cloud (VPC) (Cloud privato virtuale (VPC)
Prerequisiti
Prima di poterla utilizzare Amazon Kendra per indicizzare l'origine dati Amazon RDS (Microsoft SQL Server), apporta queste modifiche al tuo Amazon RDS (Microsoft SQL Server) e AWS agli account.
In Amazon RDS (Microsoft SQL Server), assicurati di avere:
-
Hai annotato il nome utente e la password del database.
È consigliabile fornire credenziali Amazon Kendra di database di sola lettura.
-
Hai copiato l'URL, la porta e l'istanza dell'host del database.
-
Selezionato, ogni documento è unico in Amazon RDS (Microsoft SQL Server) e tra le altre fonti di dati che intendi utilizzare per lo stesso indice. Ogni origine dati che desideri utilizzare per un indice non deve contenere lo stesso documento in tutte le fonti di dati. Gli ID dei documenti sono globali rispetto a un indice e devono essere univoci per indice.
Nel tuo Account AWS, assicurati di avere:
-
Ha creato un Amazon Kendra indice e, se si utilizza l'API, ha annotato l'ID dell'indice.
-
Hai creato un IAM ruolo per la tua origine dati e, se utilizzi l'API, hai annotato l'ARN del IAM ruolo.
Se modifichi il tipo di autenticazione e le credenziali, devi aggiornare il IAM ruolo per accedere all'ID AWS Secrets Manager segreto corretto.
-
Ha archiviato le credenziali di autenticazione Amazon RDS (Microsoft SQL Server) in un AWS Secrets Manager segreto e, se si utilizza l'API, ha annotato l'ARN del segreto.
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (ove applicabile).
Se non disponi di un IAM ruolo o di un segreto esistente, puoi utilizzare la console per creare un nuovo IAM ruolo e Secrets Manager segreto quando connetti la tua origine dati Amazon RDS (Microsoft SQL Server) a Amazon Kendra. Se utilizzi l'API, devi fornire l'ARN di un IAM ruolo e di un Secrets Manager segreto esistenti e un ID di indice.
Istruzioni di connessione
Per connetterti Amazon Kendra alla tua origine dati Amazon RDS (Microsoft SQL Server) devi fornire i dettagli delle tue credenziali Amazon RDS (Microsoft SQL Server) in modo da Amazon Kendra poter accedere ai tuoi dati. Se non hai ancora configurato Amazon RDS (Microsoft SQL Server), Amazon Kendra consultaPrerequisiti.
- Console
-
Per connettersi Amazon Kendra a Amazon RDS (Microsoft SQL Server)
-
Accedere a AWS Management Console e aprire la Amazon Kendra console.
-
Dal riquadro di navigazione a sinistra, scegli Indici, quindi scegli l'indice che desideri utilizzare dall'elenco degli indici.
Puoi scegliere di configurare o modificare le impostazioni del controllo dell'accesso degli utenti in Impostazioni dell'indice.
-
Nella pagina Guida introduttiva, scegli Aggiungi origine dati.
-
Nella pagina Aggiungi origine dati, scegli Connettore Amazon RDS (Microsoft SQL Server), quindi scegli Aggiungi connettore. Se si utilizza la versione 2 (se applicabile), scegliere il connettore Amazon RDS (Microsoft SQL Server) con il tag «V2.0".
-
Nella pagina Specificare i dettagli dell'origine dati, inserisci le seguenti informazioni:
-
In Nome e descrizione, per Nome dell'origine dati, inserisci un nome per l'origine dati. Puoi includere trattini ma non spazi.
-
(Facoltativo) Descrizione: immetti una descrizione facoltativa per la tua fonte di dati.
-
In Lingua predefinita: scegli una lingua per filtrare i documenti per l'indice. Se non diversamente specificato, la lingua predefinita è l'inglese. La lingua specificata nei metadati del documento ha la precedenza sulla lingua selezionata.
-
In Tag, per Aggiungi nuovo tag, includi tag opzionali per cercare e filtrare le risorse o tenere traccia dei costi. AWS
-
Seleziona Successivo.
-
Nella pagina Definisci accesso e sicurezza, inserisci le seguenti informazioni:
-
In Source, inserisci le seguenti informazioni:
-
Host: immettere il nome host del database.
-
Porta: immettere la porta del database.
-
Istanza: immettere l'istanza del database.
-
Abilita la posizione del certificato SSL: scegli di inserire il Amazon S3 percorso del file del certificato SSL.
-
In Autenticazione, inserisci le seguenti informazioni:
-
AWS Secrets Manager segreto: scegli un segreto esistente o crea un nuovo Secrets Manager segreto per archiviare le credenziali di autenticazione Amazon RDS (Microsoft SQL Server). Se scegli di creare un nuovo segreto, si apre una finestra AWS Secrets Manager segreta.
-
Inserisci le seguenti informazioni nella finestra Crea un AWS
Secrets Manager segreto:
-
Nome segreto: un nome per il tuo segreto. Il prefisso 'AmazonKendra-Amazon RDS (Microsoft SQL Server) -' viene aggiunto automaticamente al nome segreto.
-
Per nome utente e password del database: immettere i valori delle credenziali di autenticazione copiati dal database.
-
Selezionare Salva.
-
Virtual Private Cloud (VPC): puoi scegliere di utilizzare un VPC. In tal caso, è necessario aggiungere sottoreti e gruppi di sicurezza VPC.
-
IAM ruolo: scegli un IAM ruolo esistente o creane uno nuovo IAM per accedere alle credenziali del repository e indicizzare il contenuto.
IAM i ruoli utilizzati per gli indici non possono essere utilizzati per le fonti di dati. Se non sei sicuro che un ruolo esistente venga utilizzato per un indice o una FAQ, scegli Crea un nuovo ruolo per evitare errori.
-
Seleziona Successivo.
-
Nella pagina Configura le impostazioni di sincronizzazione, inserisci le seguenti informazioni:
-
Nell'ambito della sincronizzazione, scegli tra le seguenti opzioni:
-
Query SQL: immetti istruzioni di query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
Se il nome di una tabella include caratteri speciali (non alfanumerici) nel nome, è necessario utilizzare parentesi quadre attorno al nome della tabella. Ad esempio, seleziona*
da [] my-database-table
-
Colonna chiave primaria: fornisce la chiave primaria per la tabella del database. Identifica una tabella all'interno del database.
-
Colonna del titolo: fornisce il nome della colonna del titolo del documento all'interno della tabella del database.
-
Colonna del corpo: fornisce il nome della colonna del corpo del documento all'interno della tabella del database.
-
In Configurazione aggiuntiva, facoltativa, scegli una delle seguenti opzioni per sincronizzare contenuti specifici anziché sincronizzare tutti i file:
-
Colonne di rilevamento delle modifiche: immetti i nomi delle colonne che Amazon Kendra verranno utilizzate per rilevare le modifiche al contenuto. Amazon Kendra reindicizzerà il contenuto in caso di modifica in una di queste colonne.
-
Colonna ID utente: immetti il nome della colonna che contiene gli ID utente a cui consentire l'accesso ai contenuti.
-
Colonna Gruppi: immetti il nome della colonna che contiene i gruppi a cui consentire l'accesso ai contenuti.
-
Colonna URL di origine: inserisci il nome della colonna che contiene gli URL di origine da indicizzare.
-
Colonna timestamp: immetti il nome della colonna che contiene i timestamp. Amazon Kendra utilizza le informazioni relative alla marca temporale per rilevare le modifiche ai contenuti e sincronizzare solo i contenuti modificati.
-
Colonna dei fusi orari: inserisci il nome della colonna che contiene i fusi orari per il contenuto da sottoporre a scansione.
-
Formato timestamp: immetti il nome della colonna che contiene i formati di timestamp da utilizzare per rilevare le modifiche ai contenuti e risincronizzare i contenuti.
-
Modalità di sincronizzazione: scegli come aggiornare l'indice quando il contenuto della fonte dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione.
-
Sincronizzazione completa: indicizza di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.
-
Nuova sincronizzazione modificata: indicizza solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.
-
Sincronizzazione nuova, modificata ed eliminata: indicizza solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.
-
Pianificazione di esecuzione di In Sync, per Frequenza: con quale frequenza Amazon Kendra verrà eseguita la sincronizzazione con la fonte di dati.
-
Seleziona Successivo.
-
Nella pagina Imposta mappature dei campi, inserisci le seguenti informazioni:
-
Seleziona uno dei campi di origine dati predefiniti generati (ID documento, titoli dei documenti e URL di origine) che desideri mappare per indicizzare. Amazon Kendra
-
Aggiungi campo: consente di aggiungere campi di origine dati personalizzati per creare un nome di campo indice a cui mappare e il tipo di dati del campo.
-
Seleziona Successivo.
-
Nella pagina Rivedi e crea, verifica che le informazioni inserite siano corrette, quindi seleziona Aggiungi origine dati. Puoi anche scegliere di modificare le tue informazioni da questa pagina. L'origine dati verrà visualizzata nella pagina Origini dati dopo che l'origine dati sarà stata aggiunta correttamente.
- API
-
Per connettersi Amazon Kendra a Amazon RDS (Microsoft SQL Server)
È necessario specificare quanto segue utilizzando l'TemplateConfigurationAPI:
-
Origine dati: specifica il tipo di origine dati come JDBC
quando usi lo schema TemplateConfigurationJSON. Specificate anche l'origine dati come TEMPLATE
quando chiamate l'CreateDataSourceAPI.
-
Tipo di database: è necessario specificare il tipo di database comesqlserver
.
-
Query SQL: specifica le istruzioni di query SQL come le operazioni SELECT e JOIN. Le query SQL devono pesare meno di 32 KB. Amazon Kendra eseguirà la scansione di tutto il contenuto del database che corrisponde alla tua query.
Se il nome di una tabella include caratteri speciali (non alfanumerici) nel nome, è necessario utilizzare parentesi quadre attorno al nome della tabella. Ad esempio, seleziona*
da [] my-database-table
-
Modalità di sincronizzazione: specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione. Puoi scegliere tra:
-
FORCED_FULL_CRAWL
per indicizzare nuovamente tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.
-
FULL_CRAWL
per indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.
-
CHANGE_LOG
per indicizzare solo contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.
-
Secret Amazon Resource Name (ARN): fornisci l'Amazon Resource Name (ARN) di un Secrets Manager segreto che contiene le credenziali di autenticazione che hai creato nel tuo account ( Amazon RDS Microsoft SQL Server). Il segreto è memorizzato in una struttura JSON con le seguenti chiavi:
{
"user name": "database user name"
,
"password": "password"
}
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (ove applicabile).
-
IAM ruolo: specifica RoleArn
quando chiami CreateDataSource
per fornire a un IAM ruolo le autorizzazioni per accedere al tuo Secrets Manager segreto e per chiamare le API pubbliche richieste per il connettore ( Amazon RDS Microsoft SQL Server) e. Amazon Kendra Per ulteriori informazioni, consulta IAM ruoli per le origini dati Amazon RDS (Microsoft SQL Server).
Puoi anche aggiungere le seguenti funzionalità opzionali:
-
Virtual Private Cloud (VPC): VpcConfiguration
specifica quando si chiama. CreateDataSource
Per ulteriori informazioni, consulta Configurazione Amazon Kendra per l'utilizzo di un Amazon VPC.
-
Filtri di inclusione ed esclusione: puoi specificare se includere contenuti specifici utilizzando ID utente, gruppi, URL di origine, timestamp e fusi orari.
-
Filtraggio del contesto utente e controllo degli accessi:Amazon Kendra esegue la ricerca per indicizzazione dell'elenco di controllo degli accessi (ACL) dei documenti, se disponi di un ACL per i documenti. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del relativo gruppo ai documenti. Per ulteriori informazioni, consulta Filtraggio del contesto utente.
-
Mappature dei campi: scegliere di mappare i campi dell'origine dati ( Amazon RDS Microsoft SQL Server) ai Amazon Kendra campi indice. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
Il campo del corpo del documento o l'equivalente del corpo del documento per i documenti è necessario per Amazon Kendra eseguire la ricerca nei documenti. È necessario mappare il nome del campo del corpo del documento nella fonte dati al nome del campo indice_document_body
. Tutti gli altri campi sono facoltativi.
Per un elenco di altre importanti chiavi JSON da configurare, consultaAmazon RDS Schema del modello (Microsoft SQL Server).
Note
-
Le righe del database eliminate non verranno registrate durante la Amazon Kendra verifica della presenza di contenuti aggiornati.
-
La dimensione dei nomi e dei valori dei campi in una riga del database non può superare i 400 KB.
-
Se l'origine dati del database contiene una grande quantità di dati e non desideri Amazon Kendra indicizzare tutto il contenuto del database dopo la prima sincronizzazione, puoi scegliere di sincronizzare solo i documenti nuovi, modificati o eliminati.
-
È consigliabile fornire credenziali Amazon Kendra di database di sola lettura.
-
È consigliabile evitare di aggiungere tabelle con dati sensibili o informazioni personali identificabili (PII).