Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Creación de una base de conocimiento conectándose a un almacén de datos estructurados
Bases de conocimiento de Amazon Bedrock le permite conectarse a almacenes de datos estructurados, que contienen datos que se ajustan a un esquema predefinido. Entre los ejemplos de datos estructurados se incluyen las tablas y las bases de datos. Bases de conocimiento de Amazon Bedrock puede convertir las consultas de los usuarios en un lenguaje adecuado para extraer datos de los almacenes de datos estructurados compatibles. Luego, puede usar la consulta convertida para recuperar los datos relevantes para la consulta y generar las respuestas adecuadas. Esto le permite utilizar los datos estructurados existentes directamente sin tener que convertirlos a un formato diferente ni generar sus propias consultas SQL.
Tras configurar la base de conocimiento, puede enviar consultas para recuperar datos de la misma mediante la operación [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html) o generar respuestas a partir de los datos recuperados mediante la operación [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html). Estas operaciones convierten de forma subyacente las consultas de los usuarios en consultas adecuadas para el almacén de datos estructurados conectado a la base de conocimiento.
También tiene la opción de convertir las consultas independientemente de la recuperación de datos con la operación de la API [GenerateQuery](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GenerateQuery.html). Esta operación convierte las consultas de lenguaje natural en consultas SQL adecuadas para el origen de datos que se va a consultar. Puede utilizar esta operación de forma independiente e insertarla en su flujo de trabajo.
Seleccione un tema para obtener información sobre los requisitos previos y el proceso para conectar su base de conocimiento a un almacén de datos estructurados.
**Topics**
+ [Configuración del motor de consultas y los permisos para crear una base de conocimiento con un almacén de datos estructurados](knowledge-base-prereq-structured.md)
+ [Creación de una base de conocimiento conectándola a un almacén de datos estructurados](knowledge-base-structured-create.md)
+ [Sincronización del almacén de datos estructurados con su base de conocimiento de Amazon Bedrock](kb-data-source-structured-sync-ingest.md)
# Configuración del motor de consultas y los permisos para crear una base de conocimiento con un almacén de datos estructurados
En este tema se describen los permisos que necesita para conectar su base de conocimiento a un almacén de datos estructurados. Si planea conectar una base de conocimiento de Amazon Bedrock a un almacén de datos estructurados, debe cumplir los requisitos previos. Para conocer los requisitos generales de permisos que deben cumplirse, consulte [Configuración de los permisos de un usuario o rol para crear y administrar bases de conocimiento](knowledge-base-prereq-permissions-general.md).
**importante**
La ejecución de consultas SQL arbitrarias puede suponer un riesgo de seguridad para cualquier Text-to-SQL aplicación. Le recomendamos que tome las precauciones necesarias, como utilizar roles restringidos, bases de datos de solo lectura y entornos de pruebas.
Bases de conocimiento de Amazon Bedrock utiliza Amazon Redshift como el motor de consultas para consultar el almacén de datos. Un motor de consultas accede a los metadatos de un almacén de datos estructurados y los utiliza para ayudar a generar consultas SQL. Amazon Redshift es un servicio de almacén de datos que usa SQL para analizar datos estructurados en almacenes de datos, bases de datos y lagos de datos.
## Creación del motor de consultas de Amazon Redshift
Puede usar Amazon Redshift sin servidor o Amazon Redshift aprovisionado, según su caso de uso y conectarse a grupos de trabajo o clústeres para el almacén de datos. Los datos subyacentes que el motor Amazon Redshift puede consultar pueden ser datos almacenados de forma nativa en clústeres de Amazon Redshift o datos ubicados de forma predeterminada AWS Glue Data Catalog (como en Amazon S3, entre otros).
Puede omitir este requisito previo si ya ha creado un motor de consultas. De lo contrario, realice los siguientes pasos para configurar su motor de consultas de Amazon Redshift aprovisionado o Amazon Redshift sin servidor:
**Cómo configurar un motor de consultas en Amazon Redshift aprovisionado**
1. Siga el procedimiento de [Paso 1: creación de un clúster de Amazon Redshift de ejemplo](https://docs.aws.amazon.com/redshift/latest/gsg/new-user.html#rs-gsg-launch-sample-cluster) de la Guía de introducción a Amazon Redshift.
1. Anote el ID del clúster.
1. (Opcional) Para obtener más información acerca de los clústeres aprovisionados de Amazon Redshift, consulte [Clústeres aprovisionados de Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html) en la Guía de administración de Amazon Redshift.
**Cómo configurar un motor de consultas en Amazon Redshift sin servidor**
1. Siga únicamente el procedimiento de configuración que se describe en [Creación de un almacén de datos con Amazon Redshift sin servidor](https://docs.aws.amazon.com/redshift/latest/gsg/new-user-serverless.html#serverless-console-resource-creation) de la Guía de introducción a Amazon Redshift y configúrelo con los ajustes predeterminados.
1. Anote el ARN del grupo de trabajo.
1. (Opcional) Para obtener más información sobre los grupos de trabajo de Amazon Redshift sin servidor, consulte [Grupos de trabajo y espacios de nombres](https://docs.aws.amazon.com/redshift/latest/mgmt/serverless-workgroup-namespace.html) en la Guía de administración de Amazon Redshift.
## Configuración de los permisos del motor de consultas de Amazon Redshift
En función del motor de consultas de Amazon Redshift que elija, puede configurar determinados permisos. Los permisos que configure dependen del método de autenticación. En la siguiente tabla se muestran los métodos de autenticación que se pueden usar para los distintos motores de consultas:
****
| Método de autenticación | Amazon Redshift aprovisionado | Amazon Redshift sin servidor |
| --- | --- | --- |
| IAM | ![\[Green circular icon with a white checkmark symbol inside.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-yes.png)Sí | ![\[Green circular icon with a white checkmark symbol inside.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-yes.png)Sí |
| Nombre de usuario de la base de datos | ![\[Green circular icon with a white checkmark symbol inside.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-yes.png)Sí | ![\[Red circular icon with an X symbol, indicating cancellation or denial.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-no.png)No |
| AWS Secrets Manager | ![\[Green circular icon with a white checkmark symbol inside.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-yes.png)Sí | ![\[Green circular icon with a white checkmark symbol inside.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-yes.png)Sí |
Bases de conocimiento de Amazon Bedrock utiliza un [rol de servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) para conectar las bases de conocimiento con los almacenes de datos estructurados, recuperar datos de estos almacenes de datos y generar consultas SQL basadas en las consultas de los usuarios y la estructura de los almacenes de datos.
**nota**
Si piensa utilizar el Consola de administración de AWS para crear una base de conocimientos, puede omitir este requisito previo. La consola creará un rol de servicio de Bases de conocimiento de Amazon Bedrock con los permisos adecuados.
Para crear un rol de servicio de IAM personalizado con los permisos adecuados, siga los pasos que se indican en [Creación de un rol para delegar permisos a un Servicio de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) y asocie la relación de confianza definida en [Relación de confianza](kb-permissions.md#kb-permissions-trust).
A continuación, añada permisos para que su base de conocimiento pueda acceder al motor de consultas y a las bases de datos de Amazon Redshift. Amplíe la sección que se corresponda con su caso de uso:
### Su motor de consultas está aprovisionado por Amazon Redshift
Asocie la siguiente política a su rol de servicio personalizado para que pueda acceder a sus datos y generar consultas con ellos:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "RedshiftDataAPIStatementPermissions",
"Effect": "Allow",
"Action": [
"redshift-data:GetStatementResult",
"redshift-data:DescribeStatement",
"redshift-data:CancelStatement"
],
"Resource": [
"*"
],
"Condition": {
"StringEquals": {
"redshift-data:statement-owner-iam-userid": "${aws:userid}"
}
}
},
{
"Sid": "RedshiftDataAPIExecutePermissions",
"Effect": "Allow",
"Action": [
"redshift-data:ExecuteStatement"
],
"Resource": [
"arn:aws:redshift:us-east-1:123456789012:cluster:${Cluster}"
]
},
{
"Sid": "SqlWorkbenchAccess",
"Effect": "Allow",
"Action": [
"sqlworkbench:GetSqlRecommendations",
"sqlworkbench:PutSqlGenerationContext",
"sqlworkbench:GetSqlGenerationContext",
"sqlworkbench:DeleteSqlGenerationContext"
],
"Resource": "*"
},
{
"Sid": "GenerateQueryAccess",
"Effect": "Allow",
"Action": [
"bedrock:GenerateQuery"
],
"Resource": "*"
}
]
}
```
------
También debe añadir permisos para permitir que su rol de servicio se autentique en el motor de consultas. Amplíe una sección para ver los permisos de ese método.
------
#### [ IAM ]
Para que su rol de servicio pueda autenticarse en su motor de consultas aprovisionado por Amazon Redshift con IAM, asocie la siguiente política a su rol de servicio personalizado:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "GetCredentialsWithFederatedIAMCredentials",
"Effect": "Allow",
"Action": "redshift:GetClusterCredentialsWithIAM",
"Resource": [
"arn:aws:redshift:us-east-1:123456789012:dbname:Cluster/database"
]
}
]
}
```
------
------
#### [ Database user ]
Para autenticarse como usuario de la base de datos de Amazon Redshift, asocie la siguiente política al rol de servicio:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "GetCredentialsWithClusterCredentials",
"Effect": "Allow",
"Action": [
"redshift:GetClusterCredentials"
],
"Resource": [
"arn:aws:redshift:us-east-1:123456789012:dbuser:${cluster}/${dbuser}",
"arn:aws:redshift:us-east-1:123456789012:dbname:${cluster}/${database}"
]
}
]
}
```
------
------
#### [ AWS Secrets Manager ]
Para permitir que su rol de servicio se autentique en el motor de consultas aprovisionado por Amazon Redshift con AWS Secrets Manager un secreto, haga lo siguiente:
+ Asocie la política siguiente al rol:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "GetSecretPermissions",
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue"
],
"Resource": [
"arn:aws:secretsmanager:${region}:${account}:secret:${secretName}"
]
}
]
}
```
------
### Su motor de consultas es Amazon Redshift sin servidor
Los permisos que se pueden asociar dependen del método de autenticación. Amplíe una sección para ver los permisos de ese método.
------
#### [ IAM ]
Para que su rol de servicio pueda autenticarse en su motor de consultas de Amazon Redshift sin servidor con IAM, asocie la siguiente política a su rol de servicio personalizado:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "RedshiftServerlessGetCredentials",
"Effect": "Allow",
"Action": "redshift-serverless:GetCredentials",
"Resource": [
"arn:aws:redshift-serverless:us-east-1:123456789012:workgroup/WorkgroupId"
]
}
]
}
```
------
------
#### [ AWS Secrets Manager ]
Para permitir que su rol de servicio se autentique en el motor de consultas aprovisionado por Amazon Redshift con AWS Secrets Manager un secreto, haga lo siguiente:
+ Asocie la política siguiente al rol:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "GetSecretPermissions",
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue"
],
"Resource": [
"arn:aws:secretsmanager:${region}:${account}:secret:${secretName}"
]
}
]
}
```
------
## Autorización para que el rol de servicio de la base de conocimiento acceda a su almacén de datos
Asegúrese de que sus datos estén almacenados en uno de los siguientes [almacenes de datos estructurados compatibles](knowledge-base-structured-create.md):
+ Amazon Redshift
+ AWS Glue Data Catalog (AWS Lake Formation)
En la siguiente tabla se resumen los métodos de autenticación disponibles para el motor de consultas, en función del almacén de datos:
****
| Método de autenticación | Amazon Redshift | AWS Glue Data Catalog (AWS Lake Formation) |
| --- | --- | --- |
| IAM | ![\[Green circular icon with a white checkmark symbol inside.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-yes.png)Sí | ![\[Green circular icon with a white checkmark symbol inside.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-yes.png)Sí |
| Nombre de usuario de la base de datos | ![\[Green circular icon with a white checkmark symbol inside.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-yes.png)Sí | ![\[Red circular icon with an X symbol, indicating cancellation or denial.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-no.png)No |
| AWS Secrets Manager | ![\[Green circular icon with a white checkmark symbol inside.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-yes.png)Sí | ![\[Red circular icon with an X symbol, indicating cancellation or denial.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/icon-no.png)No |
Para obtener información sobre cómo configurar los permisos para que su rol de servicio de Bases de conocimiento de Amazon Bedrock acceda al almacén de datos y genere consultas basadas en dicho almacén, amplíe la sección correspondiente al servicio en el que se encuentra su almacén de datos:
### Amazon Redshift
Para conceder a su rol de servicio de Bases de conocimiento de Amazon Bedrock acceso a su base de datos de Amazon Redshift, utilice el [editor de consultas v2 de Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/query-editor-v2.html) y ejecute los siguientes comandos SQL:
1. (Si se autentica con IAM y aún no se ha creado un usuario para la base de datos) Ejecute el siguiente comando, que utiliza CREATE USER para [crear un usuario](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_USER.html) de base de datos y permitir que se autentique a través de IAM, sustituyéndolo *\$1\$1service-role\$1* por el nombre del rol de servicio personalizado de Amazon Bedrock Knowledge Bases que creó:
```
CREATE USER "IAMR:${service-role}" WITH PASSWORD DISABLE;
```
**importante**
Si utiliza el rol de servicio de Bases de conocimiento de Amazon Bedrock creado para usted en la consola y, a continuación, [sincroniza el almacén de datos](kb-data-source-structured-sync-ingest.md) antes de realizar este paso, se creará el usuario automáticamente, pero la sincronización fallará porque no se le han concedido permisos para acceder a su almacén de datos. Debe realizar el siguiente paso antes de la sincronización.
1. Otorgue permisos de identidad para recuperar información de su base de datos ejecutando el comando [GRANT](https://docs.aws.amazon.com/redshift/latest/dg/r_GRANT.html).
------
#### [ IAM ]
```
GRANT SELECT ON ALL TABLES IN SCHEMA ${schemaName} TO "IAMR:${serviceRole}";
```
------
#### [ Database user ]
```
GRANT SELECT ON ALL TABLES IN SCHEMA ${schemaName} TO "${dbUser}";
```
------
#### [ AWS Secrets Manager username ]
```
GRANT SELECT ON ALL TABLES IN SCHEMA ${schemaName} TO "${secretsUsername}";
```
------
**importante**
No conceda acceso `CREATE`, `UPDATE` ni `DELETE`. La concesión de estas acciones puede provocar una modificación no intencionada de sus datos.
Para tener un control más preciso de las tablas a las que se puede acceder, puede sustituir los nombres `ALL TABLES` específicos de las tablas por la siguiente notación:. *\$1\$1schemaName\$1* *\$1\$1tableName\$1* Para obtener más información sobre esta notación, consulte la sección **Objetos de consulta** en [Consultas entre bases de datos](https://docs.aws.amazon.com/redshift/latest/dg/cross-database-overview.html).
------
#### [ IAM ]
```
GRANT SELECT ON ${schemaName}.${tableName} TO "IAMR:${serviceRole}";
```
------
#### [ Database user ]
```
GRANT SELECT ON ${schemaName}.${tableName} TO "${dbUser}";
```
------
#### [ AWS Secrets Manager username ]
```
GRANT SELECT ON ${schemaName}.${tableName} TO "${secretsUsername}";
```
------
1. Si ha creado un esquema nuevo en la base de datos de Redshift, ejecute el siguiente comando para conceder permisos de identidad para el nuevo esquema.
```
GRANT USAGE ON SCHEMA ${schemaName} TO "IAMR:${serviceRole}";
```
### AWS Glue Data Catalog
Para conceder a su función de servicio de Amazon Bedrock Knowledge Bases acceso a su almacén de AWS Glue Data Catalog datos, utilice el [editor de consultas Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/query-editor-v2.html) v2 y ejecute los siguientes comandos SQL:
1. Ejecute el siguiente comando, que usa [CREATE USER para crear un usuario](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_USER.html) de base de datos y permitir que se autentique a través de IAM, sustituyéndolo *\$1\$1service-role\$1* por el nombre del rol de servicio personalizado de Amazon Bedrock Knowledge Bases que creó:
```
CREATE USER "IAMR:${service-role}" WITH PASSWORD DISABLE;
```
**importante**
Si utiliza el rol de servicio de Bases de conocimiento de Amazon Bedrock creado para usted en la consola y, a continuación, [sincroniza el almacén de datos](kb-data-source-structured-sync-ingest.md) antes de realizar este paso, se creará el usuario automáticamente, pero la sincronización fallará porque no se le han concedido permisos para acceder a su almacén de datos. Debe realizar el siguiente paso antes de la sincronización.
1. Otorgue permisos de rol de servicio para recuperar información de su base de datos ejecutando el comando [GRANT](https://docs.aws.amazon.com/redshift/latest/dg/r_GRANT.html):
```
GRANT USAGE ON DATABASE awsdatacatalog TO "IAMR:${serviceRole}";
```
**importante**
No conceda acceso `CREATE`, `UPDATE` ni `DELETE`. La concesión de estas acciones puede provocar una modificación no intencionada de sus datos.
1. Para permitir el acceso a sus AWS Glue Data Catalog bases de datos, asocie los siguientes permisos a la función de servicio:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"glue:GetDatabases",
"glue:GetDatabase",
"glue:GetTables",
"glue:GetTable",
"glue:GetPartitions",
"glue:GetPartition",
"glue:SearchTables"
],
"Resource": [
"arn:aws:glue:us-east-1:123456789012:table/${DatabaseName}/${TableName}",
"arn:aws:glue:us-east-1:123456789012:database/${DatabaseName}",
"arn:aws:glue:us-east-1:123456789012:catalog"
]
}
]
}
```
------
1. Otorgue permisos a su función de servicio de la siguiente manera AWS Lake Formation (para obtener más información sobre Lake Formation y su relación con Amazon Redshift, consulte [Fuentes de datos de Redshift](https://docs.aws.amazon.com/redshift/latest/dg/copy-parameters-data-source.html)):
1. Inicie sesión en y abra la Consola de administración de AWS consola de Lake Formation en [https://console.aws.amazon.com/lakeformation/](https://console.aws.amazon.com/lakeformation/).
1. En el panel de navegación izquierdo, seleccione **Permisos de datos**.
1. Conceda permisos al rol de servicio que está utilizando para Bases de conocimiento de Amazon Bedrock.
1. Conceda los permisos **Describe** y **Select** para sus bases de datos y tablas.
1. En función de la fuente de datos que utilice AWS Glue Data Catalog, es posible que necesite añadir permisos para acceder a esa fuente de datos (para obtener más información, consulte la sección [sobre la AWS Glue dependencia de otras](https://docs.aws.amazon.com/glue/latest/dg/dependency-on-other-services.html) fuentes Servicios de AWS). Por ejemplo, si su origen de datos se encuentra en una ubicación de Amazon S3, tendrá que añadir la siguiente instrucción a la política anterior.
```
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetObject"
],
"Resource": [
"arn:aws:s3:::${BucketName}",
"arn:aws:s3:::${BucketName}/*"
]
}
```
1. (Opcional) Si lo utiliza AWS KMS para cifrar los datos en Amazon S3 o AWS Glue Data Catalog, entonces necesita añadir permisos al rol para descifrar los datos de la clave de KMS.
```
{
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:${Region}:${Account}:key/{KmsId}",
"arn:aws:kms:${Region}:${Account}:key/{KmsId}"
],
"Effect": "Allow"
}
```
# Creación de una base de conocimiento conectándola a un almacén de datos estructurados
Para conectar una base de conocimiento a un almacén de datos estructurados, debe especificar los siguientes componentes:
+
**Configuración del motor de consultas**
La configuración del servicio de computación que ejecutará las consultas SQL generadas El motor de consultas se utiliza para convertir las consultas de los usuarios en lenguaje natural en consultas SQL que se pueden utilizar para extraer datos del almacén de datos. Puede elegir Amazon Redshift como motor de consultas. Al elegir esta configuración, debe especificar:
+ Los metadatos de la conexión del recurso de computación, como el ID del clúster o el ARN del grupo de trabajo, según el motor de consultas elegido.
+ El método de autenticación para utilizar el motor de consultas, que puede consistir en utilizar un rol de servicio de IAM con los permisos adecuados, un usuario de la base de datos del motor de consultas o un AWS Secrets Manager secreto vinculado a las credenciales de la base de datos.
+
**Configuración de almacenamiento**
La configuración del almacén de datos que contiene los datos. Puede conectarse a Amazon Redshift Provisioned o Amazon Redshift Serverless y usar Amazon Redshift o como almacén de datos. AWS Glue Data Catalog
+
**(Opcional) Configuraciones de consulta**
Puede usar configuraciones de consulta opcionales para mejorar la precisión de la generación de SQL:
+ **Tiempo máximo de consulta**: la cantidad de tiempo después del cual se agota el tiempo de espera de la consulta.
+ **Descripciones**: proporciona metadatos o información complementaria sobre tablas o columnas. Puede incluir descripciones de las tablas o columnas, notas de uso o cualquier atributo adicional. Las descripciones que agregue pueden mejorar la generación de consultas SQL al proporcionar contexto e información adicionales sobre la estructura de las tablas o columnas.
+ **Inclusiones y exclusiones**: especifica un conjunto de tablas o columnas que se van a incluir o excluir para la generación de SQL. Este campo es crucial si desea limitar el alcance de las consultas SQL a un subconjunto definido de tablas o columnas disponibles. Esta opción puede ayudar a optimizar el proceso de generación al reducir las referencias innecesarias de tablas o columnas.
Si especifica inclusiones, se ignoran todas las demás tablas y columnas. Si especifica exclusiones, se ignoran las tablas y columnas que especifique.
**nota**
Las inclusiones y exclusiones no sustituyen a las barreras de protección y solo están pensadas para mejorar la precisión del modelo.
+ **Consultas preparadas**: un conjunto de ejemplos predefinidos de preguntas y respuestas. Las preguntas se escriben como consultas en lenguaje natural (NLQ) y las respuestas son la consulta SQL correspondiente. Estos ejemplos ayudan al proceso de generación de SQL al proporcionar ejemplos de los tipos de consultas que se deben generar. Sirven como puntos de referencia para mejorar la precisión y la relevancia de las salidas de SQL generativo.
Amplíe la sección que se corresponda con su caso de uso:
## Uso de la consola
Para conectarse a un almacén de datos estructurado mediante el Consola de administración de AWS, haga lo siguiente:
1. Inicie sesión Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock)
1. En el panel de navegación izquierdo, elija **Bases de conocimientos**.
1. En la sección **Bases de conocimientos**, elija **Crear** y, a continuación, elija **Base de conocimientos con almacén de datos estructurados**.
1. Configure los siguientes detalles para la base de conocimiento:
1. (Opcional) Cambie el nombre predeterminado y proporcione una descripción para la base de conocimiento.
1. Seleccione el motor de consultas que se utilizará para recuperar los datos del almacén de datos.
1. Elija un rol de servicio de IAM con los permisos adecuados para crear y administrar esta base de conocimiento. Puede dejar que Amazon Bedrock cree el rol de servicio o elegir un rol personalizado que haya creado. Para obtener más información sobre cómo crear un rol personalizado, consulte [Configuración del motor de consultas y los permisos para crear una base de conocimiento con un almacén de datos estructurados](knowledge-base-prereq-structured.md).
1. (Opcional) Añada etiquetas para asociarlas a la base de conocimiento. Para obtener más información, consulte [Etiquetado de los recursos de Amazon Bedrock](tagging.md).
1. Elija **Siguiente**.
1. Configure su motor de consultas:
1. Seleccione el servicio en el que creó un clúster o un grupo de trabajo. A continuación, elija el clúster o grupo de trabajo que desea usar.
1. Seleccione el método de autenticación y proporcione los campos necesarios.
1. Seleccione el almacén de datos en el que desea almacenar los metadatos. A continuación, elija o escriba el nombre de la base de datos.
1. (Opcional) Modifique las configuraciones de consulta según sea necesario. Consulte el principio de este tema para obtener más información sobre las diferentes configuraciones.
1. Elija **Siguiente**.
1. Revise las configuraciones de la base de conocimiento y edite las secciones según sea necesario. Confirme la operación para crear su base de conocimiento.
## Uso de la API de
Para conectarse a un almacén de datos estructurado mediante la API de Amazon Bedrock, envíe una [CreateKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateKnowledgeBase.html)solicitud con un [punto final de tiempo de compilación de Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) con el siguiente cuerpo de solicitud general:
```
{
"name": "string",
"roleArn": "string",
"knowledgeBaseConfiguration": {
"type": "SQL",
"sqlKnowledgeBaseConfiguration": [SqlKnowledgeBaseConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_SqlKnowledgeBaseConfiguration.html)
},
"description": "string",
"clientToken": "string",
"tags": {
"string": "string"
}
}
```
Los siguientes campos son obligatorios:
****
| Campo | Descripción básica |
| --- | --- |
| Name | Un nombre para la base de conocimiento |
| roleArn | Un [rol de servicio de la base de conocimiento](kb-permissions.md) con los permisos adecuados. Puede utilizar la consola para crear un rol de servicio de forma automática con los permisos adecuados. |
| knowledgeBaseConfiguration | Contiene configuraciones para la base de conocimiento. Para una base de datos estructurados, especifique SQL como type e incluya el campo sqlKnowledgeBaseConfiguration. |
Los siguientes campos son opcionales.
****
| Campo | Uso |
| --- | --- |
| description | Incluir una descripción de la base de conocimiento. |
| clientToken | Para garantizar que la solicitud de la API se complete solo una vez. Para obtener más información, consulte [Ensuring idempotency](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html). |
| etiquetas | Para asociar etiquetas con el flujo. Para obtener más información, consulte [Etiquetado de los recursos de Amazon Bedrock](tagging.md). |
`SQLKnowledgeBaseConfiguration` depende del motor de consultas que utilice. Para Amazon Redshift, especifique el `type` campo como `REDSHIFT` e inclúyalo`redshiftConfiguration`, que se asigna a. [RedshiftConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_RedshiftConfiguration.html) Para el [RedshiftConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_RedshiftConfiguration.html), debe configurar los siguientes campos:
### queryEngineConfiguration
Puede configurar los siguientes tipos de motor de consultas:
#### Amazon Redshift aprovisionado
Si las bases de datos de Amazon Redshift se aprovisionan en nodos de procesamiento dedicados, el valor del `queryEngineConfiguration` campo debe tener [RedshiftQueryEngineConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_RedshiftQueryEngineConfiguration.html)el siguiente formato:
```
{
"type": "PROVISIONED",
"provisionedConfiguration": {
"clusterIdentifier": "string",
"authConfiguration": [RedshiftProvisionedAuthConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_RedshiftProvisionedAuthConfiguration.html)
},
}
```
Especifique el ID del clúster en el campo `clusterIdentifier`. [RedshiftProvisionedAuthConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_RedshiftProvisionedAuthConfiguration.html)Depende del tipo de autorización que utilice. Seleccione la pestaña que coincida con su método de autorización:
------
#### [ IAM role ]
Si realiza la autorización con su rol de IAM, solo debe especificar `IAM` como el tipo en [RedshiftProvisionedAuthConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_RedshiftProvisionedAuthConfiguration.html) sin campos adicionales.
```
{
"type": "IAM"
}
```
------
#### [ Temporary credentials user name ]
Si realiza la autorización con el nombre de usuario de la base de datos, especifique `type` como `USERNAME` y especifique el nombre de usuario en el campo `databaseUser` en `RedshiftProvisionedAuthConfig`:
```
{
"type": "USERNAME",
"databaseUser": "string"
}
```
------
#### [ AWS Secrets Manager ]
Si autoriza con AWS Secrets Manager, especifique el `type` as `USERNAME_PASSWORD` y el ARN del secreto en el `usernamePasswordSecretArn` campo de: `RedshiftProvisionedAuthConfig`
```
{
"type": "USERNAME_PASSWORD",
"usernamePasswordSecretArn": "string"
}
```
------
#### Amazon Redshift sin servidor
Si utiliza Amazon Redshift Serverless, el valor del `queryConfiguration` campo debe tener el siguiente [RedshiftQueryEngineConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_RedshiftQueryEngineConfiguration.html)formato:
```
{
"type": "SERVERLESS",
"serverlessConfiguration": {
"workgroupArn": "string",
"authConfiguration":
}
}
```
Especifique el ARN de su grupo de trabajo en el campo `workgroupArn`. [RedshiftServerlessAuthConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_RedshiftServerlessAuthConfiguration.html)Depende del tipo de autorización que utilice. Seleccione la pestaña que coincida con su método de autorización:
------
#### [ IAM role ]
Si realiza la autorización con su rol de IAM, solo debe especificar `IAM` como el tipo en `RedshiftServerlessAuthConfiguration` sin campos adicionales.
```
{
"type": "IAM"
}
```
------
#### [ AWS Secrets Manager ]
Si autoriza con AWS Secrets Manager, especifique el `type` as `USERNAME_PASSWORD` y el ARN del secreto en el `usernamePasswordSecretArn` campo de: `RedshiftServerlessAuthConfiguration`
```
{
"type": "USERNAME_PASSWORD",
"usernamePasswordSecretArn": "string"
}
```
------
### storageConfigurations
Este campo se asigna a una matriz que contiene un único campo [RedshiftQueryEngineStorageConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_RedshiftQueryEngineStorageConfiguration.html), cuyo formato depende del lugar donde estén almacenados los datos.
#### AWS Glue Data Catalog
Si los datos están almacenados en AWS Glue Data Catalog, `RedshiftQueryEngineStorageConfiguration` deben tener el siguiente formato:
```
{
"type": "AWS_DATA_CATALOG",
"awsDataCatalogConfiguration": {
"tableNames": ["string"]
}
}
```
Agregue el nombre de cada tabla a la que desee conectar su base de conocimiento en la matriz a la que se asigna `tableNames`.
**nota**
Introduzca los nombres de las tablas siguiendo el patrón descrito en [Consultas entre bases de datos](https://docs.aws.amazon.com/redshift/latest/dg/cross-database-overview.html) (`${databaseName}.${tableName}`). Puede incluir todas las tablas especificando `${databaseName.*}`.
#### Bases de datos de Amazon Redshift
Si los datos están almacenados en una base de datos de Amazon Redshift, `RedshiftQueryEngineStorageConfiguration` debe tener el siguiente formato:
```
{
"type": "string",
"redshiftConfiguration": {
"databaseName": "string"
}
}
```
Especifique el nombre de la base de datos de Amazon Redshift en el campo `databaseName`.
**nota**
Introduzca los nombres de las tablas siguiendo el patrón descrito en [Consultas entre bases de datos](https://docs.aws.amazon.com/redshift/latest/dg/cross-database-overview.html) (`${databaseName}.${tableName}`). Puede incluir todas las tablas especificando `${databaseName.*}`.
Si la base de datos se monta a través de Amazon SageMaker AI Lakehouse, el nombre de la base de datos estará en el formato*\$1\$1db\$1@\$1\$1schema\$1*.
### queryGenerationConfiguration
Este campo se asigna a lo siguiente, [QueryGenerationConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationConfiguration.html)que puede usar para configurar la forma en que se consultan los datos:
```
{
"executionTimeoutSeconds": number,
"generationContext": {
"tables": [
{
"name": "string",
"description": "string",
"inclusion": "string",
"columns": [
{
"name": "string",
"description": "string",
"inclusion": "string"
},
...
]
},
...
],
"curatedQueries": [
{
"naturalLanguage": "string",
"sql": "string"
},
...
]
}
}
```
Si desea que se agote el tiempo de espera de la consulta, especifique la duración del tiempo de espera en segundos en el campo `executionTimeoutSeconds`.
El `generationContext` campo se asigna a un [QueryGenerationContext](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationContext.html)objeto en el que puede configurar tantas de las siguientes opciones como necesite.
**importante**
Si incluye un contexto de generación, el motor de consultas hace todo lo posible por aplicarlo al generar SQL. El contexto de generación no es determinista y solo pretende mejorar la precisión del modelo. Para garantizar la precisión, compruebe las consultas de SQL generativo.
Para obtener información sobre los contextos de generación que puede incluir, amplíe las siguientes secciones:
#### Agregación de descripciones para las tablas o columnas de la base de datos
Para mejorar la precisión de la generación de SQL para consultar la base de datos, puede proporcionar una descripción de la tabla o columna que proporcione más contexto que un nombre corto de tabla o columna. Se puede hacer lo siguiente:
+ Para añadir una descripción a una tabla, incluya un [QueryGenerationTable](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationTable.html)objeto en la `tables` matriz. En ese objeto, especifique el nombre de la tabla en el campo `name` y una descripción en el campo `description`, como en el ejemplo siguiente:
```
{
"name": "database.schema.tableA",
"description": "Description for Table A"
}
```
+ Para añadir una descripción a una columna, incluya un [QueryGenerationTable](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationTable.html)objeto en la `tables` matriz. En ese objeto, especifique el nombre de la tabla en el `name` campo e incluya el `columns` campo, que se asigna a una matriz de [QueryGenerationColumn](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationColumn.html). En un objeto `QueryGenerationColumn`, incluya el nombre de la tabla en el campo `name` y una descripción en el campo `description`, como en el ejemplo siguiente:
```
{
"name": "database.schema.tableA",
"columns": [
{
"name": "Column A",
"description": "Description for Column A"
}
]
}
```
+ Puede añadir una descripción para una tabla y para una columna, como en el siguiente ejemplo:
```
{
"name": "database.schema.tableA",
"description": "Description for Table A",
"columns": [
{
"name": "columnA",
"description": "Description for Column A"
}
]
}
```
**nota**
Introduzca los nombres de las tablas y columnas siguiendo el patrón descrito en [Consultas entre bases de datos](https://docs.aws.amazon.com/redshift/latest/dg/cross-database-overview.html). Si la base de datos está en AWS Glue Data Catalog, el formato es`awsdatacatalog.gluedatabase.table`.
#### Inclusión o exclusión de tablas o columnas en la base de datos
Puede sugerir tablas o columnas para incluirlas o excluirlas al generar SQL mediante el `inclusion` campo de los [QueryGenerationColumn](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationColumn.html)objetos [QueryGenerationTable](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationTable.html)y. Puede especificar uno de los siguientes valores en el campo `inclusion`:
+ INCLUIR: solo las tablas o columnas que especifique se incluyen como contexto al generar SQL.
+ EXCLUIR: las tablas o columnas que especifique se excluyen como contexto al generar SQL.
Puede especificar si desea incluir o excluir tablas o columnas de las siguientes maneras:
+ Para incluir o excluir una tabla, incluya un [QueryGenerationTable](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationTable.html)objeto en la `tables` matriz. En ese objeto, especifique el nombre de la tabla en el campo `name` y si desea incluirla o excluirla en el campo `inclusion`, como en el ejemplo siguiente:
```
{
"name": "database.schema.tableA",
"inclusion": "EXCLUDE"
}
```
El motor de consultas no añade `Table A` en el contexto adicional para generar SQL.
+ Para incluir o excluir una columna, incluya un [QueryGenerationTable](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationTable.html)objeto en la `tables` matriz. En ese objeto, especifique el nombre de la tabla en el `name` campo e incluya el `columns` campo, que se asignará a una matriz de [QueryGenerationColumn](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationColumn.html). En un objeto `QueryGenerationColumn`, especifique el nombre de la columna en el campo `name` y si desea incluirla o excluirla en el campo `inclusion`, como en el ejemplo siguiente:
```
{
"name": "database.schema.tableA",
"columns": [
{
"name": "database.schema.tableA.columnA",
"inclusion": "EXCLUDE"
}
]
}
```
La generación de SQL ignora `Column A` en `Table A` en el contexto al generar SQL.
+ Puede combinar tablas y columnas al especificar inclusiones o exclusiones, como en el siguiente ejemplo:
```
{
"name": "database.schema.tableA",
"inclusion": "INCLUDE",
"columns": [
{
"name": "database.schema.tableA.columnA",
"inclusion": "EXCLUDE"
}
]
}
```
La generación de SQL incluye `Table A`, pero excluye `Column A`, al añadir contexto para generar SQL.
**importante**
Las exclusiones de tablas y columnas no sustituyen a las barreras de protección. Estas inclusiones y exclusiones de tablas y columnas se utilizan como contexto adicional para que el modelo lo tenga en cuenta al generar SQL.
#### Cómo proporcionar al motor de consultas ejemplos de correspondencia entre el lenguaje natural y las consultas SQL
Para mejorar la precisión de un motor de consultas a la hora de convertir las consultas de los usuarios en consultas SQL, puede proporcionarles ejemplos en el `curatedQueries` campo del [QueryGenerationContext](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_QueryGenerationContext.html)objeto, que se asigna a una matriz de [CuratedQuery](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CuratedQuery.html)objetos. Cada objeto incluye los siguientes campos:
+ naturalLanguage: un ejemplo de consulta en lenguaje natural.
+ sql: la consulta SQL que corresponde a la consulta en lenguaje natural.
# Sincronización del almacén de datos estructurados con su base de conocimiento de Amazon Bedrock
Tras conectar la base de conocimiento a un almacén de datos estructurados, realiza una sincronización para iniciar el proceso de ingesta de metadatos y poder recuperar los datos. Los metadatos permiten a Bases de conocimiento de Amazon Bedrock convertir las peticiones de los usuarios en una consulta para la base de datos conectada.
Siempre que realice modificaciones en el esquema de la base de datos, necesitará sincronizar los cambios.
Para obtener más información sobre cómo ingerir los datos en la base de conocimiento y sincronizarlos con los datos más recientes, seleccione la pestaña correspondiente al método que prefiera y siga estos pasos:
------
#### [ Console ]
**Ingesta de los datos en la base de conocimientos y sincronización con los datos más actuales**
1. Abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/).
1. En el panel de navegación izquierdo, seleccione **Base de conocimientos** y elija su base de conocimientos.
1. En la sección **Origen de datos**, seleccione **Sincronizar** para iniciar el proceso de ingesta de metadatos. Para detener la sincronización actual de un origen de datos, seleccione **Detener**. Un origen de datos debe estar sincronizándose para poder detener la sincronización. Puede seleccionar **Sincronizar** para ingerir el resto de los datos.
1. Cuando se complete la ingesta de datos, aparecerá un banner verde de confirmación si se ha realizado correctamente.
1. Puede elegir un origen de datos para ver su **Historial de sincronización**. Seleccione **Ver advertencias** para ver por qué ha fallado un trabajo de ingesta de datos.
------
#### [ API ]
Para ingerir los datos en la base de conocimiento y sincronizarlos con los datos más recientes, envíe una solicitud [StartIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StartIngestionJob.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).
Utilice el `ingestionJobId` devuelto en la respuesta a una solicitud [GetIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetIngestionJob.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) para realizar un seguimiento del estado del trabajo de ingesta.
También puede ver la información de todos los trabajos de ingesta de un origen de datos enviando una solicitud [ListIngestionJobs](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListIngestionJobs.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).
Para detener un trabajo de ingesta de datos que se está ejecutando actualmente, envíe una solicitud [StopIngestionJobs](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StopIngestionJob.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Puede volver a enviar una solicitud `StartIngestionJob` para ingerir el resto de los datos cuando esté listo.
------
**importante**
Si utiliza el rol de servicio de Bases de conocimiento de Amazon Bedrock creado para usted en la consola y, a continuación, sincroniza el almacén de datos antes de conceder acceso a la base de datos al rol de autenticación que utiliza, la sincronización fallará porque no se han concedido permisos al usuario para acceder a su almacén de datos. Para obtener información sobre cómo conceder permisos a un rol para acceder a su almacén de datos, consulte [Autorización para que el rol de servicio de la base de conocimiento acceda a su almacén de datos](knowledge-base-prereq-structured.md#knowledge-base-prereq-structured-db-access).