Introducción a Oracle NoSQL Database Cloud Service

Oracle NoSQL Database Cloud Service es un servicio en la nube de base de datos totalmente gestionado diseñado para operaciones de base de datos que requieren respuestas predecibles de latencia en milisegundos de Un dígito para consultas simples.

NoSQL Database Cloud Service permite a los desarrolladores centrarse en el desarrollo, en lugar de configurar servidores del cluster, o realizar el control, el ajuste, el diagnóstico y la ampliación del sistema. NoSQL Database Cloud Service es adecuado para aplicaciones como Internet of Things, personalización de la experiencia del usuario, detección instantánea de fraudes y publicidad display en línea.

Una vez que se haya autenticado con su cuenta de Oracle Cloud, puede crear una tabla de NoSQL y especificar los requisitos de rendimiento y almacenamiento para la tabla. Oracle reserva y gestiona el recurso para satisfacer sus requisitos, y le ofrece la capacidad que necesita. La capacidad se especifica utilizando unidades de lectura y escritura para el rendimiento global y GB para las unidades de almacenamiento.

En este artículo se incluyen los siguientes temas:

Enlaces Rápidos

Puede empezar a utilizar Oracle NoSQL Database Service mediante uno de los siguientes enlaces rápidos:

Tabla - Enlaces rápidos


Introducción - Inicio rápido: Introducción - Funciones clave - Conceptos de la nube - Precios	Conexión - Adquisición de credenciales - Autenticación para conectarse a NDCS - Conexión de la aplicación a NDCS - Regiones de datos y puntos finales de servicio asociados	IDE and SDKs - Using IntelliJ Plugin for Development - Using Visual Studio Code Extension for Development - Oracle NoSQL Java SDK - Oracle NoSQL Python SDK - Oracle NoSQL GO SDK - Oracle NoSQL Node.js SDK - Oracle NoSQL Dotnet SDK - Oracle NoSQL Rust SDK
Creación de tablas - Diseño de una tabla - Uso de la consola para crear tablas únicas - Uso de API para crear tablas únicas - Tablas activas globales - Uso de la consola para crear una tabla activa global - Uso de API para crear una tabla activa global - Uso de la CLI de OCI para crear una tabla	Poner y explorar datos - Uso de la consola para agregar datos - Uso de API para agregar datos - Uso de la consola para recuperar datos - Uso de Get API para recuperar datos - Uso de la API de consulta para recuperar datos - Consulta de tablas principal-secundario	Gestión de Tablas - Modificación de Tablas Únicas mediante API - Modificación de Tablas Activas Globales mediante API - Borrado de Tablas e Índices - Gestión de Tablas e Índices mediante la Consola
Gestión de seguridad - Configuración de grupos de usuarios y políticas - Otorgamiento de otro permiso de usuario para gestionar tablas NoSQL - Referencia de política	Supervisión del servicio - Eventos de servicio - Cuotas de servicio - Métricas - Creación y gestión de alarmas	Utilidades - Descargar Oracle NoSQL Database Cloud Simulator - Desarrollo en el simulador de la nube de Oracle NoSQL Database - Uso del migrador de Oracle NoSQL Database - Uso de Oracle NoSQL Database Analytics Integrator
Referencia de SQL - Uso de operadores en SQL - Ordenación de agrupación y limitación de datos - Uso de expresiones primarias en SQL - Uso de funciones de registro de hora en consultas - Uso de funciones de cadena en consultas	Guías de referencia - Referencia de Analytics Integrator - Casos de uso de ejemplo para NDCS - Solución de problemas con GAT

Configuración del servicio

Si va a configurar Oracle NoSQL Database Cloud Service por primera vez, siga estas tareas como guía.

Tarea	Referencia	Información relacionada
Realice un pedido de Oracle NoSQL Database Cloud Service o regístrese para la prueba gratuita deOracle.	Registro en Oracle Cloud Infrastructure en la documentación de Oracle Cloud Infrastructure.	Para obtener más información sobre cómo calcular el costo mensual de la suscripción a Oracle NoSQL Database Cloud Service, consulte Estimación del costo mensual. Para actualizar su cuenta gratuita o cambiar el método de pago, consulte Cambio del método de pago en la documentación de Oracle Cloud Infrastructure.
Activación de la cuenta de Oracle Cloud y conectarse por primera vez.	Conexión a la consola en Oracle Cloud Infrastructure Documentation.	Para familiarizarse con la consola de Oracle Cloud Infrastructure, consulte Uso de la consola en la documentación de Oracle Cloud Infrastructure.
(Recomendado) Creación de un compartimento para el servicio.	Creación de un compartimiento	Si no está familiarizado con los compartimentos, consulte Descripción de los compartimentos en la documentación de Oracle Cloud Infrastructure.
Gestione la seguridad del servicio.	Acerca del modelo de seguridad de Oracle NoSQL Database Cloud Service	Para familiarizarse con el modelo del servicio NoSQL Database Cloud, consulte Acerca de modelo del servicio de seguridad Oracle NoSQL Database Cloud Service.

Acceso al servicio desde la consola del Infrastructure

Aprenda a acceder al servicio Oracle NoSQL Database Cloud Service desde la consola de Infrastructure.

Localice la URL de servicio en el correo electrónico de bienvenida y, a continuación, conéctese a Oracle NoSQL Database Cloud Service.
Abra el menú de navegación, haga clic en Bases de datos y, a continuación, en NoSQL Database.
Seleccione el compartimento creado para las tablas por el administrador de servicio.

Para consultar la ayuda de la página actual, haga clic sobre el icono de ayuda Icono de cajón de ayuda en la parte superior de la página.

Creación de un compartimiento

Al registrarse en Oracle Cloud Infrastructure, Oracle crea el arrendamiento con un compartimento raíz que contiene todos los recursos en la nube. A continuación, puede crear compartimentos adicionales en el arrendamiento (compartimento raíz) y las políticas correspondientes para controlar el acceso a los recursos de cada compartimento. Antes de crear una tabla de Oracle NoSQL Database Cloud Service, Oracle recomienda que configure el compartimento al cual deseaque pertenezca la tabla.

Los compartimentos se crean en Oracle Cloud Infrastructure Identity and Access Management (IAM). Consulte Configuración de arrendamiento y Gestión de compartimentos en la documentación de Oracle Cloud Infrastructure.

Autenticación para conectarse a Oracle NoSQL Database

Necesita una cuenta de Oracle Cloud para conectar su aplicación a Oracle NoSQL Database Cloud Service.

Si aún no tiene una cuenta de Oracle Cloud, puede empezar con Oracle Cloud. Debe autenticarse cuando se conecte a Oracle NoSQL Database. Se puede autenticar mediante una de las siguientes formas:

Método de autenticación n.º 1: principales de usuario

Aquí puede utilizar un usuario de OCI y una clave de API para la autenticación. Las credenciales que se utilizan para conectar la aplicación se asocian a un usuario específico. Si desea crear un usuario para la aplicación, consulte Configuración de usuarios, grupos y políticas mediante Identity and Access Management.

Puede proporcionar sus credenciales para este método de autenticación mediante una de las siguientes formas:

Mediante un archivo en un disco local, el archivo contiene detalles como el OCID del usuario, el OCID del arrendamiento, la región, la ruta de clave privada y la huella. Puede utilizar esta opción si trabaja desde una red segura y el almacenamiento local de configuraciones y claves privadas cumple las políticas de seguridad.
Proporcionar las credenciales a través de una API.
Almacenar las credenciales en un almacén en algún lugar.

Información que contienen las credenciales:

Tabla - Credenciales

¿Qué es?	¿Dónde encontrarlo?
ID de arrendamiento e ID de usuario (ambos son OCID)	Consulte Dónde obtener el OCID del arrendamiento y el OCID del usuario en la documentación de Oracle Cloud Infrastructure.
Clave de firma de API	Para el usuario de la aplicación, se debe generar y cargar una clave de firma de API. Si ya se ha realizado, este paso se puede omitir. Para obtener más información, consulte los siguientes recursos en la documentación de Oracle Cloud Infrastructure: Cómo Generar una Clave de Firma de API para generar la clave de firma con una frase de contraseña opcional. Cómo cargar la clave política para cargar la clave para firmar la API en la cuenta del usuario.
Huella de la clave de firma y (opcional) frase de contraseña de la clave de firma	Al generar y cargar la clave de firma de API, se crean la huella y contraseña de la clave de firma. Consulte Cómo obtener la huella de la clave en la documentación de Oracle Cloud Infrastructure.

¿Qué es?

¿Dónde encontrarlo?

ID de arrendamiento e ID de usuario (ambos son OCID)

Consulte Dónde obtener el OCID del arrendamiento y el OCID del usuario en la documentación de Oracle Cloud Infrastructure.

Clave de firma de API

Para el usuario de la aplicación, se debe generar y cargar una clave de firma de API. Si ya se ha realizado, este paso se puede omitir.

Para obtener más información, consulte los siguientes recursos en la documentación de Oracle Cloud Infrastructure:

Cómo Generar una Clave de Firma de API para generar la clave de firma con una frase de contraseña opcional.
Cómo cargar la clave política para cargar la clave para firmar la API en la cuenta del usuario.

Huella de la clave de firma y (opcional) frase de contraseña de la clave de firma

Al generar y cargar la clave de firma de API, se crean la huella y contraseña de la clave de firma. Consulte Cómo obtener la huella de la clave en la documentación de Oracle Cloud Infrastructure.

Nota: Anote la ubicación de su clave privada, contraseña opcional y huella de la Clave Pública durante la generación y carga de la Clave de Firma de API.

Después de realizar las tareas descritas anteriormente, recopile la información de las credenciales y proporciónela a la aplicación.

Proporcionar las credenciales a la aplicación:

Los SDK de Oracle NoSQL Database permiten proporcionar las credenciales a una aplicación de varias formas. Los SDK admiten un archivo de configuración, así como una o más interfaces que permiten la especificación directa de la información. Consulte la documentación del controlador del lenguaje de programación que utiliza para conocer las interfaces en las credenciales específicas.

Si utiliza un archivo de configuración, la ubicación por defecto es ~/.oci/config. Los SDK permiten que el archivo resida en ubicaciones alternativas. Su contenido tiene el aspecto siguiente:

[DEFAULT]
user=ocid1.user.oc1..aaaaaaaas...7ap
fingerprint=d1:b2:32:53:d3:5f:cf:68:2d:6f:8b:5f:77:8f:07:13
key_file=~/.oci/oci_api_key_private.pem
tenancy=ocid1.tenancy.oc1..aaaaaaaap...keq
pass_phrase=mysecretphrase

La línea [DEFAULT] indica que las líneas que siguen especifican el perfil DEFAULT. Un archivo de configuración puede incluir varios perfiles con el prefijo [PROFILE_NAME]. Por ejemplo:

[DEFAULT]
user=ocid1.user.oc1..aaaaaaaas...7us
fingerprint=d1:b2:32:53:d3:5f:cf:68:2d:6f:8b:5f:77:8f:07:15
key_file=~/.oci/oci_api_key_private.pem
tenancy=ocid1.tenancy.oc1..aaaaabbap...keq
pass_phrase=mysecretphrase

[MYPROFILE]
user=ocid1.user.oc1..aaaaaaaas...7ap
fingerprint=d1:b2:32:53:d3:5f:cf:68:2d:6f:8b:5f:77:8f:07:13
key_file=~/.oci/oci_api_key_private.pem
tenancy=ocid1.tenancy.oc1..aaaaaaaap...keq
pass_phrase=mysecretphrase

Método de autenticación n.º 2: principales de instancia

Instance Principals es una función de Oracle Cloud Infrastructure Identity and Access Management (IAM) que permite realizar llamadas de servicio desde una instancia. Con los principales de instancia, no necesita configurar las credenciales de usuario para los servicios que se ejecutan en las instancias informáticas ni rotar las credenciales. Las propias instancias ahora son un tipo de principal en IAM. Cada instancia informática tiene su propia identidad y se autentica mediante los certificados que se le agregan a la instancia. Estos certificados se crean, asignan a las instancias y se rotan automáticamente.

Mediante la autenticación de los principales de instancia, puede autorizar una instancia para que realice llamadas a ella en los servicios deOracle Cloud Infrastructure. Después de configurar los recursos y las políticas necesarios, una aplicación que se ejecuta en una instancia puede llamar a los servicios públicos de Oracle Cloud Infrastructure, eliminando la necesidad de configurar las credenciales de usuario o un archivo de configuración. La autenticación de principal de la instancia se puede utilizar desde una instancia en la que no desea almacenar un archivo de configuración.

Método de autenticación n.º 3: entidades de recurso

Puede utilizar una entidad de recurso para autenticar y acceder a los recursos de Oracle Cloud Infrastructure. La entidad de recurso consta de un token de sesión temporal y credenciales seguras que permiten a otros servicios de Oracle Cloud autenticarse en Oracle NoSQL Database. La autenticación de entidad de recurso es muy similar a la autenticación de principal de instancia, pero está destinada a utilizarse para recursos que no son instancias, como las funciones sin servidor.

Una entidad de recurso permite que los recursos estén autorizados para realizar acciones en los servicios de Oracle Cloud Infrastructure. Cada recurso tiene su propia identidad y se autentica mediante los certificados que se le agregan. Estos certificados se crean, asignan a recursos y rotan automáticamente, evitando la necesidad de que cree y gestione sus propias credenciales para acceder al recurso. Al autenticarse mediante una entidad de recurso, no necesita crear ni gestionar credenciales para acceder a los recursos de Oracle Cloud Infrastructure.

Una vez autenticado, debe estar autorizado para acceder a los recursos de Oracle Cloud Infrastructure. Consulte Configuración de usuarios, grupos y políticas mediante Identity and Access Management para obtener más información.

Método de autenticación #4: Autenticación basada en token

La autenticación basada en token permite crear y utilizar un token de sesión temporal para autenticar y acceder a los recursos de Oracle Cloud Infrastructure. Mediante el uso de la autenticación basada en token, cree un archivo del tipo configuración local que contenga información como el OCID de usuario, el OCID de arrendamiento, la región, la ruta de acceso a clave privada y una ruta de acceso a archivo del símbolo de sesión temporal. Este método utiliza esta información junto con el token de sesión temporal, que caduca en una hora (valor por defecto). La autenticación basada en token de sesión se puede utilizar cuando necesite autenticación rápida y temporal.

Creación de un token de sesión: puede generar un token de sesión con o sin un explorador web.

Con un explorador:

Para utilizar la autenticación basada en token para CLI en una computadora con un explorador web:

En el terminal, ejecute el siguiente comando:
```
oci session authenticate
```
Seleccionar una región.
En el explorador, introduzca sus credenciales de usuario.
Después de la autenticación correcta, cierre el explorador y siga el indicador interactivo en el terminal. Debe proporcionar el nombre del perfil que desea crear en el archivo de configuración. La nueva configuración de perfil se escribe en el archivo ~/.oci/config. A continuación se muestra un ejemplo del archivo de configuración en el que se actualiza el nuevo perfil (por ejemplo, TEST).
```
[TEST]
user=<ocid1.user.oc1.........>
fingerprint=<XX:XX:...........>
key_file=<C:\Users\XXXXXX\.oci\oci_api_key_private.pem>
tenancy=<ocid1.tenancy.oc1.....>
region=us-ashburn-1
security_token_file=<C:\Users\XXXXXX\.oci\sessions\TEST\token>
```

Sin un explorador:

Para utilizar la autenticación basada en token para la CLI sin un explorador web, primero debe autenticarse mediante la autenticación basada en clave de API.

oci setup config

Este comando le solicita la información necesaria para crear el archivo de configuración y las claves pública y privada de API. El cuadro de diálogo de configuración utiliza esta información para generar un par de claves de API y crea el archivo de configuración. Para utilizar la autenticación basada en token para la CLI sin un explorador web, ejecute el siguiente comando:

oci session authenticate --no-browser

Debe proporcionar el nombre del perfil que desea crear en el archivo de configuración. La nueva configuración de perfil se escribe en el archivo ~/.oci/config. A continuación se muestra un ejemplo del archivo de configuración en el que se actualiza el nuevo perfil (por ejemplo, TEST).

[TEST]
user=<ocid1.user.oc1.........>
fingerprint=<XX:XX:...........>
key_file=<full_directory_path_oci_api_key_private.pem>
tenancy=<ocid1.tenancy.oc1.....>
region=us-ashburn-1
security_token_file=<full_directory_path_token>

Método de autenticación n.º 5: autenticación basada en identidad de carga de trabajo de OKE

La identidad de carga de trabajo de Oracle Container Engine for Kubernetes (OKE) proporciona un control de gestión de identidad y acceso detallado. Una carga de trabajo es una aplicación que se ejecuta en Kubernetes. Puede estar compuesto por un único componente o varios componentes que funcionan juntos ejecutándose dentro de un juego de pods. Un recurso de carga de trabajo se identifica mediante la combinación única de cluster, espacio de nombres y cuenta de servicio. Esta combinación única se denomina identidad de carga de trabajo. OKE Workload Identity permite otorgar a los pods de K8s acceso basado en políticas a los recursos de Oracle Cloud Infrastructure (OCI) mediante OCI Identity and Access Management (IAM).

Con Workload Identity, ya no es necesario almacenar credenciales como secretos en el cluster de Kubernetes ni depender de grupos dinámicos de OCI para el acceso basado en políticas de nodos de trabajador a recursos de OCI y, más específicamente, al acceso a las tablas de NoSQL. Cuando las aplicaciones requieren acceso a los recursos de OCI, Workload Identity le permite escribir políticas de OCI IAM en el ámbito de la cuenta de servicio de Kubernetes asociada a los pods de aplicación. Esta función permite a las aplicaciones que se ejecutan dentro de estos pods acceder directamente a la API de OCI en función de los permisos proporcionados por las políticas.

Para otorgar a todos los pods de una carga de trabajo acceso a cualquier recurso de OCI:

Cree un espacio de nombres para una cuenta de servicio.
Cree una cuenta de servicio para que la aplicación la utilice.
Defina una política de IAM para otorgar acceso al recurso de carga de trabajo a otros recursos de OCI.
Descargue y configure el SDK adecuado para el idioma en el que se escribe la aplicación.
Edite la aplicación para especificar:
- que las solicitudes de carga de trabajo se autenticarán mediante el proveedor de identidad de carga de trabajo de Kubernetes Engine
- los recursos de OCI a los que se va a acceder
Actualice la especificación de despliegue de la aplicación para especificar que cada pod de la carga de trabajo debe utilizar la cuenta de servicio.

Autorización para permitir que la carga de trabajo acceda a los recursos de OCI necesarios:

En la consola de OCI, abra el menú de navegación y haga clic en Identidad y seguridad. En Identidad, haga clic en Políticas.
Haga clic en Crear política y asigne un nombre a la política.

Introduzca una sentencia de política para permitir que la carga de trabajo acceda a los recursos de OCI necesarios, en el formato que se muestra a continuación:

Allow any-user to <verb> <resource> in <location> where all
{
request.principal.type = 'workload',
request.principal.namespace = '<namespace-name>',
request.principal.service_account = '<service-account-name>',
request.principal.cluster_id = '<cluster-ocid>'
}

donde:

<namespace-name> es el nombre del espacio de nombres que ha creado anteriormente.
<service-account-name> es el nombre de la cuenta de servicio que ha creado anteriormente.
<cluster-OCID> es el OCID del cluster que ha obtenido anteriormente.

Haga clic en Crear para crear la nueva política.

Conexión de la aplicación a NDCS

Descubra Cómo conectar su aplicación a Oracle NoSQL Database Cloud Service.

La aplicación se conecta a Oracle NoSQL Database Cloud Service después de autenticarse mediante uno de los muchos métodos disponibles.

Puede autenticarse mediante una de las siguientes opciones:

clave de firma de API
- Desde cualquier programa SDK (Java, Python, C#, GO, Node.js, Rust) codificado directamente
- Un archivo de configuración con un perfil predeterminado
- Un archivo de configuración con un perfil no predeterminado
Principales de instancia con tokens de autenticación
Entidades de recurso
token de sesión
Identidad de carga de trabajo de OKE

Consulte Autenticación para conectarse a Oracle NoSQL Database para obtener más información sobre las opciones de autenticación.

Puede conectarse a NDCS mediante uno de los siguientes métodos:

Proporcionando credenciales directamente en el código:

/* Use the SignatureProvider to supply your credentials to NoSQL Database.
 * By default, the SignatureProvider will read your OCI configuration file
 * from the default location, ~/.oci/config. See SignatureProvider for
 * additional options for reading configurations in other ways.
 */

SignatureProvider sp = new SignatureProvider(
 tenantId,     // a string, OCID
 userId,       // a string, OCID
 fingerprint , // a string
 privateKey,   // a string, content of private key
 passPhrase    // optional, char[]
);
//Create an handle to access the cloud service in your service region.
NoSQLHandleConfig config = new NoSQLHandleConfig(Region.<your-service-region>);
config.setAuthorizationProvider(sp);
NoSQLHandle handle = NoSQLHandleFactory.createNoSQLHandle(config);

//At this point, your handle is set up to perform data operations.

Conexión mediante el archivo de configuración por defecto con un perfil por defecto:

/* Use the SignatureProvider to supply your credentials to NoSQL Database.
 * By default, the SignatureProvider will read your OCI configuration file
 * from the default location, ~/.oci/config. See SignatureProvider for
 * additional options for reading configurations in other ways.
 */

SignatureProvider sp = new SignatureProvider();

Conexión mediante el archivo de configuración por defecto con un perfil que no es por defecto:

/* Use the SignatureProvider to supply your credentials to NoSQL Database.
 * Specify the name of the non-default profile in the constructor for SignatureProvider. */

 final String profile_name = "<name_of_the_profile>";
 SignatureProvider sp = new  SignatureProvider(profile_name);

Conectando mediante el perfil y el archivo de configuración especificados:

/* Use the SignatureProvider to supply your credentials to NoSQL Database.
 * You specify the full path of the non-default config file and also the name
 * of the profile
 */

final String config_filepath = "<full_path_of_config_file>";
final String profile_name = "<name_of_the_profile>";
SignatureProvider sp = new SignatureProvider(config_filepath, profile_name);

Conexión mediante un principal de instancia:

Instancia de principal es una función del servicio IAM que permite que las instancias sean actores (o principales) autorizados para realizar acciones en recursos de servicio. Cada instancia informática tiene su propia identidad y se autentica con los certificados que se le agregan.
```
SignatureProvider authProvider = SignatureProvider.createWithInstancePrincipal();
```
Conexión mediante una entidad de recurso:

La entidad de recurso es una función de servicio de IAM que permite que los recursos sean actores (o entidades de seguridad) autorizados para realizar acciones en recursos de servicio
```
SignatureProvider authProvider = SignatureProvider.createWithResourcePrincipal();
```
Conexión mediante session-token:

Utilice el método createWithSessionToken() para crear un SignatureProvider mediante una lectura de token de sesión temporal desde un archivo de token. La ruta del archivo de token se lee desde el perfil por defecto del archivo de configuración en la ubicación por defecto. El archivo de configuración utilizado es ~/.oci/config.
```
SignatureProvider authProvider =
SignatureProvider.createWithSessionToken();
```
También puede proporcionar la ruta del archivo de token en el perfil no predeterminado en el archivo de configuración, como se muestra a continuación. La ruta del archivo de token se lee desde el perfil especificado en el archivo de configuración en la ubicación por defecto.
```
SignatureProvider authProvider =
SignatureProvider.createWithSessionToken(<profile_name>);
```
Conexión mediante la identidad de carga de trabajo de OKE:

Puede crear un proveedor de firmas con la identidad de carga de trabajo de Container Engine for Kubernetes (OKE) mediante el token de cuenta de servicio de Kubernetes en la ruta de acceso por defecto /var/run/secrets/kubernetes.io/serviceaccount/token. Este proveedor solo se puede utilizar dentro de pods de Kubernetes.
```
SignatureProvider authProvider =
SignatureProvider.createWithOkeWorkloadIdentity();
```
También puede especificar el token de cuenta de servicio de Kubernetes específico que se utilizará como se muestra a continuación.
```
SignatureProvider authProvider =
SignatureProvider.createWithOkeWorkloadIdentity(<serviceAccountToken>);
```
También puede especificar la ubicación del token de cuenta de servicio de Kubernetes específico que se va a utilizar como se muestra a continuación.
```
SignatureProvider authProvider =
SignatureProvider.createWithOkeWorkloadIdentity(<serviceAccountToken_location>);
```

Consulte SignatureProvider para obtener más información sobre las clases Java utilizadas.

Puede conectarse a NDCS mediante uno de los siguientes métodos:

Proporcionando credenciales directamente en el código:

from borneo.iam import SignatureProvider
#
# Use SignatureProvider directly via API. Note that the
# private_key argument can either point to a key file or be the
# string content of the private key itself.
#
at_provider = SignatureProvider(tenant_id='ocid1.tenancy.oc1..tenancy',
                                user_id='ocid1.user.oc1..user',
                                private_key=key_file_or_key,
                                fingerprint='fingerprint',
                                pass_phrase='mypassphrase')

Conexión mediante el archivo de configuración por defecto con un perfil por defecto:

from borneo.iam import SignatureProvider
#
# Use SignatureProvider with a default credentials file and
# profile in $HOME/.oci/config
#
at_provider = SignatureProvider()

Conexión mediante el archivo de configuración especificado con un perfil que no es por defecto:

from borneo.iam import SignatureProvider
#
# Use SignatureProvider with a non-default credentials file and profile
#
at_provider = SignatureProvider(config_file='myconfigfile',
                                profile_name='myprofile')

Conexión mediante un principal de instancia:

Instancia de principal es una función del servicio IAM que permite que las instancias sean actores (o principales) autorizados para realizar acciones en recursos de servicio. Cada instancia informática tiene su propia identidad y se autentica con los certificados que se le agregan.
```
at_provider =
SignatureProvider.create_with_instance_principal(region=my_region)
```
Conexión mediante una entidad de recurso:

La entidad de recurso es una función de servicio de IAM que permite que los recursos sean actores (o entidades de seguridad) autorizados para realizar acciones en recursos de servicio
```
at_provider = SignatureProvider.create_with_resource_principal()
```

Conexión mediante session-token:

Borneo utiliza el SDK de OCI para la autenticación mediante tokens de sesión. El firmante de OCI se transfiere como parámetro al constructor SignatureProvider, como se muestra a continuación.

from borneo.iam import SignatureProvider
# Use SignatureProvider with a provider argument which is an instance of
# oci.auth.signers.SecurityTokenSigner
at_provider = SignatureProvider(<instance of oci.auth.signers.SecurityTokenSigner>)

Conexión mediante la identidad de carga de trabajo de OKE:

El firmante de autorización de carga de trabajo de OKE es un firmante que otorga a toda una carga de trabajo (una aplicación que se ejecuta en clusters de Kubernetes) acceso a las tablas NoSQL mediante la identidad de carga de trabajo de OKE. Se puede recuperar mediante oci.auth.signers.get_oke_workload_identity_resource_principal_signer. El firmante recuperado se puede utilizar al inicializar un cliente.
```
from borneo.iam import SignatureProvider
oke_workload_signer = oci.auth.signers.get_oke_workload_identity_resource_principal_signer()
```
Si tiene una ruta de token de cuenta de servicio de Kubernetes diferente de la ruta de acceso por defecto, puede especificar la ruta de acceso como se muestra a continuación:
```
token_path = "path_to_your_token_file"
oke_workload_signer  = oci.auth.signers.get_oke_workload_identity_resource_principal_signer(service_account_token_path=token_path)
at_provider = SignatureProvider(oke_workload_signer)
```
También puede transferir directamente el token de cuenta de servicio de Kubernetes como se muestra a continuación:
```
#token_string = "your_token_string"
#oke_workload_signer = oci.auth.signers.get_oke_workload_identity_resource_principal_signer(service_account_token=token_string)
at_provider = SignatureProvider(oke_workload_signer)
```

Puede conectar la aplicación a NDCS mediante cualquiera de los siguientes métodos:

Proporcionando credenciales directamente en el código:

privateKeyFile := "/path/to/privateKeyFile"
passphrase := "examplepassphrase"
sp, err := iam.NewRawSignatureProvider("ocid1.tenancy.oc1..tenancy",
                                       "ocid1.user.oc1..user",
                                       "<your-service-region>",
                                       "fingerprint",
                                       "compartmentID",
                                       privateKeyFile ,
                                       &passphrase )
if err != nil {
    return
}
cfg := nosqldb.Config{
    AuthorizationProvider: sp,
    // This is only required if the "region" property is not
    //specified in the config file.
    Region: "<your-service-region>",
}

Conexión mediante el archivo de configuración por defecto con un perfil por defecto:

cfg := nosqldb.Config{
// This is only required if the "region" property is not
//specified in ~/.oci/config.
// This takes precedence over the "region" property when both are specified.
    Region: "<your-service-region>",
}
client, err := nosqldb.NewClient(cfg)

Conexión mediante el archivo de configuración especificado con un perfil que no es por defecto:

sp, err := iam.NewSignatureProviderFromFile("your_config_file_path",
           "your_profile_name", "", "compartment_id")
if err != nil {
    return
}
cfg := nosqldb.Config{
    AuthorizationProvider: sp,
    // This is only required if the "region" property is not specified in the config file.
    Region: "us-ashburn-1",
}
client, err := nosqldb.NewClient(cfg)

Conexión mediante un principal de instancia:

Instancia de principal es una función del servicio IAM que permite que las instancias sean actores (o principales) autorizados para realizar acciones en recursos de servicio. Cada instancia informática tiene su propia identidad y se autentica con los certificados que se le agregan.
```
sp, err := iam.NewSignatureProviderWithInstancePrincipal("compartment_id")
if err != nil {
    return
}
cfg := nosqldb.Config{
    AuthorizationProvider: sp,
    Region: "<your-service-region>",
}
client, err := nosqldb.NewClient(cfg)
```

Conexión mediante una entidad de recurso:

La entidad de recurso es una función de servicio de IAM que permite que los recursos sean actores (o entidades de seguridad) autorizados para realizar acciones en recursos de servicio

sp, err := iam.NewSignatureProviderWithResourcePrincipal("compartment_id")
if err != nil {
    return
}
cfg := nosqldb.Config{
    AuthorizationProvider: sp,
    Region: "<your-service-region>",
}
client, err := nosqldb.NewClient(cfg)

Conexión mediante session-token:

La función NewSessionTokenSignatureProvider crea un SignatureProvider mediante un token de sesión temporal leído desde un archivo de token.
```
func NewSessionTokenSignatureProvider() (*SignatureProvider, error)
```
El archivo de configuración utilizado es ~/.oci/config. Se utiliza el perfil DEFAULT. La ruta del archivo de token se lee desde la configuración, utilizando el valor del campo security_token_file. Al utilizar este constructor, el usuario tiene un compartimento por defecto para todas las tablas. Es el compartimento raíz del arrendamiento del usuario.

Para utilizar un archivo de configuración no predeterminado (que no sea ~/.oci/config), puede utilizar la función NewSessionTokenSignatureProviderFromFile.
```
func NewSessionTokenSignatureProviderFromFile(configFilePath,
ociProfile, privateKeyPassphrase string) (*SignatureProvider, error)
```
Esta función crea un SignatureProvider mediante un token de sesión temporal leído desde un archivo de token, mediante el ociProfile especificado en el archivo de configuración de OCI configFilePath. La ruta del archivo de token se lee desde la configuración, utilizando el valor del campo security_token_file. El campo privateKeyPassphrase solo es necesario si la clave privada utiliza una frase de contraseña y no se especifica en el campo pass_phrase del archivo de configuración de OCI. Al utilizar este constructor, el usuario tiene un compartimento por defecto para todas las tablas. Es el compartimento raíz del arrendamiento del usuario.

Conexión mediante la identidad de carga de trabajo de OKE:

El SDK de Oracle NoSQL go soporta la ejecución de programas dentro de contenedores de carga de trabajo de OKE en OCI. En el código que crea un proveedor de firmas para utilizarlo con NoSQL, agregue el siguiente código para utilizar la identidad de carga de trabajo de OKE:

conf, err := ociauth.OkeWorkloadIdentityConfigurationProvider()
if err != nil {
   return nil, fmt.Errorf("cannot create an Oke Provider: %v", err)
}
myconf := &myConfigProvider{conf}
sp, err := iam.NewSignatureProviderWithConfiguration(myconf, compartmentID)
if err != nil {
  return nil, fmt.Errorf("cannot create a Signature Provider: %v", err)
}

Puede conectarse a NDCS mediante uno de los siguientes métodos:

Proporcionando credenciales directamente en el código:

Puede especificar credenciales directamente como parte de la propiedad auth.iam en la configuración inicial. Cree la instancia de NoSQLClient de la siguiente manera:

import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient({
    region: <your-service-region>
    auth: {
        iam: {
            tenantId: myTenancyOCID,
            userId: myUserOCID,
            fingerprint: myPublicKeyFingerprint,
            privateKeyFile: myPrivateKeyFile,
            passphrase: myPrivateKeyPassphrase
        }
    }
});

Conexión mediante el archivo de configuración por defecto con un perfil por defecto:

Puede almacenar las credenciales en un archivo de configuración de Oracle Cloud Infrastructure. La ruta de acceso por defecto para el archivo de configuración es ~/.oci/config, donde ~ representa el directorio raíz del usuario. En Windows, ~ es un valor de la variable de entorno USERPROFILE. El archivo puede contener varios perfiles. Por defecto, el SDK utiliza el perfil denominado DEFAULT para almacenar las credenciales.

Para utilizar estos valores por defecto, cree un archivo denominado config en el directorio ~/.oci con el siguiente contenido:
```
[DEFAULT]
tenancy=<your-tenancy-ocid>
user=<your-user-ocid>
fingerprint=<fingerprint-of-your-public-key>
key_file=<path-to-your-private-key-file>
pass_phrase=<your-private-key-passphrase>
region=<your-region-identifier>
```
Tenga en cuenta que también puede especificar el identificador de región junto con las credenciales en el archivo de configuración de OCI. El controlador examinará la ubicación anterior por defecto y, si se proporciona una región junto con las credenciales, no es necesario proporcionar la configuración inicial y puede utilizar el constructor sin argumentos:
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient();
```
También puede especificar la región en la configuración:
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient({ region: Region.<your-service-region> });
```
Conexión mediante el archivo de configuración especificado con un perfil que no es por defecto:

Puede optar por utilizar una ruta de acceso diferente para el archivo de configuración de OCI, así como un perfil diferente dentro del archivo de configuración. En este caso, especifíquelos en la propiedad auth.iam de la configuración inicial. Por ejemplo, si la ruta del archivo de configuración de OCI es ~/myapp/.oci/config y almacena sus credenciales en el perfil Jane:

A continuación, cree la instancia de NoSQLClient de la siguiente forma:
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient({
    region: Region.<your-service-region>,
    auth: {
        iam: {
            configFile: '<your_config_file>',
            profileName: '<name_of_your_profile>'
        }
    }
});
```
Conexión mediante un principal de instancia:

Instancia de principal es una función del servicio IAM que permite que las instancias sean actores (o principales) autorizados para realizar acciones en recursos de servicio. Cada instancia informática tiene su propia identidad y se autentica con los certificados que se le agregan.

Una vez configurada, cree la instancia de NoSQLClient de la siguiente forma:
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
const client = new NoSQLClient({
    region: Region.<your-service-region>,
    compartment: 'ocid1.compartment.oc1..............'
    auth: {
        iam: {
            useInstancePrincipal: true
        }
    }
});
```
También puede utilizar el archivo de configuración JSON con la misma configuración que se ha descrito anteriormente. Tenga en cuenta que, al utilizar el principal de instancia, debe especificar el ID de compartimento (OCID) como propiedad de compartimento. Esto es necesario incluso si desea utilizar el compartimento por defecto. Tenga en cuenta que debe utilizar el ID de compartimento y no el nombre ni la ruta de acceso del compartimento. Además, al utilizar el principal de instancia, no puede anteponer al nombre de la tabla el nombre del compartimento ni la ruta de acceso al llamar a las API de NoSQLClient.
Conexión mediante una entidad de recurso:

La entidad de recurso es una función de servicio de IAM que permite que los recursos sean actores (o entidades de seguridad) autorizados para realizar acciones en recursos de servicio

Una vez configurada, cree la instancia de NoSQLClient de la siguiente forma:
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
const client = new NoSQLClient({
    region: Region.<your-service-region>,
    compartment: 'ocid1.compartment.oc1...........................'
    auth: {
        iam: {
            useResourcePrincipal: true
        }
    }
});
```
También puede utilizar el archivo de configuración JSON con la misma configuración que se ha descrito anteriormente. Tenga en cuenta que, al utilizar la entidad de recurso, debe especificar el ID de compartimento (OCID) como propiedad de compartimento. Esto es necesario incluso si desea utilizar el compartimento por defecto. Tenga en cuenta que debe utilizar el ID de compartimento y no el nombre ni la ruta de acceso del compartimento. Además, al utilizar la entidad de recurso, no puede anteponer al nombre de la tabla el nombre del compartimento ni la ruta de acceso al llamar a las API de NoSQLClient.
Conexión mediante session-token:

Mediante la autenticación basada en tokens de sesión, cree un archivo de configuración local que contenga información como el OCID de usuario, el OCID de arrendamiento, la región, la ruta de acceso a clave privada y una ruta de acceso a archivo del símbolo de sesión temporal.
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
const client = new NoSQLClient({
    region: Region.<your-service-region>,
    compartment: 'ocid1.compartment.oc1..............
   ' auth: {
       iam: { useSessionToken: true }
  }
});
```
Este método utiliza una lectura de token de sesión temporal de un archivo de token. La ruta de acceso del archivo de token se lee del perfil por defecto en el archivo de configuración de OCI como valor del campo security_token_file.

Para utilizar un archivo de configuración no predeterminado (que no sea ~/.oci/config), puede especificar la ruta del archivo de configuración y el nombre del perfil, como se muestra a continuación.
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
const client = new NoSQLClient({
  region: Region.<your-service-region>,
  compartment: 'ocid1.compartment.oc1..............
  ' auth: {
    iam: {  useSessionToken: true,
      "configFile": "<path_to_config_file>",
      "profileName": "<profile_name>"
    }
  }
});
```
Conexión mediante la identidad de carga de trabajo de OKE:

El SDK de Oracle NoSQL Node.js soporta la ejecución de programas dentro de contenedores de carga de trabajo de OKE en OCI.
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
const client = new NoSQLClient({
    region: Region.<your-service-region>,
    compartment: 'ocid1.compartment.oc1...........................'
    ' auth: {
        iam: { useOKEWorkloadIdentity: true }
    }'
  }
);
```
Este esquema de autorización solo se puede utilizar dentro de los pods de Kubernetes. El uso de la identidad de carga de trabajo de OKE requiere un token de cuenta de servicio. Por defecto, el proveedor cargará el token de cuenta de servicio desde la ruta de archivo por defecto /var/run/secrets/kubernetes.io/serviceaccount/token. Puede sustituir esto y proporcionar el token de cuenta de servicio especificando una de las 3 propiedades:
- serviceAccountToken para proporcionar una cadena de token de cuenta de servicio.
- serviceAccountTokenFile para proporcionar una ruta al archivo de token de cuenta de servicio.
- serviceAccountTokenProvider para proporcionar un proveedor personalizado para cargar tokens de cuenta de servicio.

Consulte Archivo de configuración de SDK para obtener detalles del contenido y el formato del archivo.

Puede conectarse a NDCS mediante uno de los siguientes métodos:

Proporcionando credenciales directamente en el código:

Puede especificar credenciales directamente como IAMCredentials al crear IAMAuthorizationProvider. Cree NoSQLClient de la siguiente manera:

var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region=<your-service-region>,
        AuthorizationProvider = new IAMAuthorizationProvider(
            new IAMCredentials
            {
                TenantId=myTenancyOCID,
                UserId=myUserOCID,
                Fingerprint=myPublicKeyFingerprint,
                PrivateKeyFile=myPrivateKeyFile
            })
    });

Conexión mediante el archivo de configuración por defecto con un perfil por defecto:

Puede almacenar las credenciales en un archivo de configuración de Oracle Cloud Infrastructure. La ruta de acceso por defecto para el archivo de configuración es ~/.oci/config, donde ~ representa el directorio raíz del usuario. En Windows, ~ es un valor de la variable de entorno USERPROFILE. El archivo puede contener varios perfiles. Por defecto, el SDK utiliza el perfil denominado DEFAULT para almacenar las credenciales

Para utilizar estos valores por defecto, cree un archivo denominado config en el directorio ~/.oci con el siguiente contenido:
```
[DEFAULT]
tenancy=<your-tenancy-ocid>
user=<your-user-ocid>
fingerprint=<fingerprint-of-your-public-key>
key_file=<path-to-your-private-key-file>
pass_phrase=<your-private-key-passphrase>
region=<your-region-identifier>
```
Tenga en cuenta que también puede especificar el identificador de región junto con las credenciales en el archivo de configuración de OCI. Por defecto, el controlador buscará credenciales y una región en el archivo de configuración de OCI en la ruta de acceso por defecto y en el perfil por defecto. Por lo tanto, si proporciona una región junto con las credenciales como se muestra anteriormente, puede crear una instancia de NoSQLClient sin transferir ninguna configuración:
```
var client = new NoSQLClient();
```
También puede especificar la región (así como otras propiedades) en NoSQLConfig:
```
var client = new NoSQLClient(
    new NoSQLConfig(
    {
        Region = Region.<your-service-region>,
        Timeout = TimeSpan.FromSeconds(10),
    }));
```
Conexión mediante el archivo de configuración especificado con un perfil que no es por defecto:

Puede optar por utilizar una ruta de acceso diferente para el archivo de configuración de OCI, así como un perfil diferente dentro del archivo de configuración. En este caso, especifíquelos dentro de la propiedad auth.iam de la configuración inicial. Por ejemplo, si la ruta del archivo de configuración de OCI es ~/myapp/.oci/config y almacena sus credenciales en el perfil Jane:

A continuación, cree la instancia de NoSQLClient de la siguiente forma:
```
var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region = Region.<your-service-region>,
        AuthorizationProvider = new IAMAuthorizationProvider(
            "<your_config_file>", "<your_profile_name>")
    });
```
Conexión mediante un principal de instancia:

Instancia de principal es una función del servicio IAM que permite que las instancias sean actores (o principales) autorizados para realizar acciones en recursos de servicio. Cada instancia informática tiene su propia identidad y se autentica con los certificados que se le agregan. Una vez configurada, cree la instancia de NoSQLClient de la siguiente forma:
```
var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region=<your-service-region>,
        Compartment="ocid1.compartment.oc1.............................",
        AuthorizationProvider=IAMAuthorizationProvider.CreateWithInstancePrincipal()
    });
```
También puede representar la misma configuración en JSON de la siguiente manera:
```
{
    "Region": "<your-service-region>",
    "AuthorizationProvider":
    {
        "AuthorizationType": "IAM",
        "UseInstancePrincipal": true
    },
    "Compartment": "ocid1.compartment.oc1.............................",
}
```
Tenga en cuenta que, al utilizar el principal de instancia, debe especificar el ID de compartimento (OCID) como propiedad compartment. Esto es necesario incluso si desea utilizar el compartimento por defecto. Tenga en cuenta que debe utilizar el ID de compartimento y no el nombre ni la ruta de acceso del compartimento. Además, al utilizar el principal de instancia, no puede anteponer al nombre de la tabla el nombre del compartimento ni la ruta de acceso al llamar a las API de NoSQLClient.
Conexión mediante una entidad de recurso:

La entidad de recurso es una función de servicio de IAM que permite que los recursos sean actores (o entidades de seguridad) autorizados para realizar acciones en recursos de servicio Una vez configurada, cree la instancia de NoSQLClient de la siguiente forma:
```
var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region = <your-service-region>,
        Compartment =
            "ocid1.compartment.oc1.............................",
        AuthorizationProvider =
            IAMAuthorizationProvider.CreateWithResourcePrincipal()
    });
```
También puede representar la misma configuración en JSON de la siguiente manera:
```
{
    "Region": "<your-service-region>",
    "AuthorizationProvider":
    {
        "AuthorizationType": "IAM",
        "UseResourcePrincipal": true
    },
    "Compartment": "ocid1.compartment.oc1.............................",
}
```
Tenga en cuenta que, al utilizar la entidad de recurso, debe especificar el ID de compartimento (OCID) como propiedad compartment. Esto es necesario incluso si desea utilizar el compartimento por defecto. Tenga en cuenta que debe utilizar el ID de compartimento y no el nombre ni la ruta de acceso del compartimento. Además, al utilizar la entidad de recurso, no puede anteponer al nombre de la tabla el nombre del compartimento ni la ruta de acceso al llamar a las API de NoSQLClient.
Conexión mediante session-token:

Mediante la autenticación basada en tokens de sesión, cree un archivo de configuración local que contenga información como el OCID de usuario, el OCID de arrendamiento, la región, la ruta de acceso a clave privada y una ruta de acceso a archivo del símbolo de sesión temporal.

Puede utilizar la autenticación basada en token de sesión mediante uno de los tres métodos que se muestran a continuación.

Opción 1: se crea una nueva instancia de IAMAuthorizationProvider mediante la autenticación basada en token de sesión con el archivo de configuración de OCI por defecto y el nombre de perfil por defecto.
```
var client = new NoSQLClient(
new NoSQLConfig {
   Region = <your-service-region>,
   Compartment = "ocid1.compartment.oc1.............................",
   AuthorizationProvider = IAMAuthorizationProvider.CreateWithSessionToken()
});
```
Opción 2: se crea una nueva instancia de IAMAuthorizationProvider mediante la autenticación basada en token de sesión con el archivo de configuración de OCI por defecto y el nombre de perfil especificado.
```
var client = new NoSQLClient(
new NoSQLConfig {
   Region = <your-service-region>,
   Compartment = "ocid1.compartment.oc1.............................",
   AuthorizationProvider = IAMAuthorizationProvider.CreateWithSessionToken(<profileName>)
});
```
Opción 3: se crea una nueva instancia de IAMAuthorizationProvider mediante la autenticación basada en token de sesión con el nombre de perfil y el archivo de configuración de OCI especificados.
```
var client = new NoSQLClient(
new NoSQLConfig {
   Region = <your-service-region>,
   Compartment = "ocid1.compartment.oc1.............................",
   AuthorizationProvider = IAMAuthorizationProvider.CreateWithSessionToken(<configFile>,<profileName>)
});
```
También puede representar la misma configuración en JSON de la siguiente manera:
```
{
  "Region": "<your-service-region>",
  "AuthorizationProvider": {
    "AuthorizationType": "IAM",
    "UseSessionToken": true
  },
  "Compartment": "ocid1.compartment.oc1............................."
}
```
Conexión mediante la identidad de carga de trabajo de OKE:

El SDK de Dotnet de Oracle NoSQL admite la ejecución de programas dentro de contenedores de carga de trabajo de OKE en OCI.

En el siguiente ejemplo se crea una nueva instancia de IAMAuthorizationProvider mediante la identidad de carga de trabajo de OKE. Este método permite especificar una cadena de token de cuenta de servicio opcional. Si no se especifica, el token de cuenta de servicio se leerá de la ruta de archivo por defecto /var/run/secrets/kubernetes.io/serviceaccount/token.
```
var client = new NoSQLClient(
new NoSQLConfig {
   Region = <your-service-region>,
   Compartment = "ocid1.compartment.oc1.............................",
   AuthorizationProvider = IAMAuthorizationProvider.CreateWithOKEWorkloadIdentity()
});
```
También puede crear una nueva instancia de IAMAuthorizationProvider mediante la identidad de carga de trabajo de OKE y el archivo de token de cuenta de servicio especificado, como se muestra a continuación.
```
var client = new NoSQLClient(
new NoSQLConfig {
   Region = <your-service-region>,
   Compartment = "ocid1.compartment.oc1.............................",
   AuthorizationProvider =
    IAMAuthorizationProvider.CreateWithOKEWorkloadIdentityAndTokenFile(<serviceAccountTokenFile>)
});
```
También puede representar la misma configuración en JSON de la siguiente manera:
```
{ "Region": "<your-service-region>",
 "AuthorizationProvider":  {
   "AuthorizationType": "IAM",
   "UseOKEWorkLoadIdentity": true
 },
 "Compartment": "ocid1.compartment.oc1.............................",
}
```

Puede conectarse a NDCS mediante uno de los siguientes métodos:

Conexión mediante el archivo de configuración por defecto con un perfil por defecto:

Puede almacenar las credenciales en un archivo de configuración de Oracle Cloud Infrastructure. La ruta de acceso por defecto para el archivo de configuración es ~/.oci/config, donde ~ representa el directorio raíz del usuario. En Windows, ~ es un valor de la variable de entorno USERPROFILE. El archivo puede contener varios perfiles. Por defecto, el SDK utiliza el perfil denominado DEFAULT para almacenar las credenciales

Para utilizar estos valores por defecto, cree un archivo denominado config en el directorio ~/.oci con el siguiente contenido:
```
[DEFAULT]
tenancy=<your-tenancy-ocid>
user=<your-user-ocid>
fingerprint=<fingerprint-of-your-public-key>
key_file=<path-to-your-private-key-file>
pass_phrase=<your-private-key-passphrase>
region=<your-region-identifier>
```
Tenga en cuenta que también puede especificar el identificador de región junto con las credenciales en el archivo de configuración de OCI. Por defecto, el controlador buscará credenciales y una región en el archivo de configuración de OCI en la ruta de acceso por defecto y en el perfil por defecto. La región solo es necesaria si no se utiliza HandleBuilder::cloud_region(). pass_phrase solo es necesario si el archivo de claves RSA requiere uno.

El primer paso en cualquier aplicación Oracle NoSQL Database Cloud Service Rust consiste en crear un manejador utilizado para enviar solicitudes al servicio, en función de la configuración proporcionada en una estructura HandleBuilder. Las instancias del manejador son seguras para el uso simultáneo y están destinadas a ser compartidas en una aplicación multithread o asíncrona. En el siguiente ejemplo de código se muestra cómo conectarse al servicio en la nube mediante un archivo de configuración de usuario:
```
let handle = Handle::builder()
.cloud_auth_from_file("~/.oci/config")?
.build().await?;
```
Conexión mediante un principal de instancia

Instancia de principal es una función del servicio IAM que permite que las instancias sean actores (o principales) autorizados para realizar acciones en recursos de servicio. Cada instancia informática tiene su propia identidad y se autentica con los certificados que se le agregan. Para configurar NoSQL en este modo, utilice el siguiente código:
```
let handle = Handle::builder()
.cloud_auth_from_instance()?
.compartment_id ("ocid1.compartment.oc1.............................")?
.build().await?;
```

Flujo de trabajo típico

Secuencia habitual de tareas para trabajar con Oracle NoSQL Database Cloud Service.

Si está desarrollando aplicaciones con Oracle NoSQL Database Cloud Service por primera vez, siga estas tareas como guía.

Tarea	Descripción	Más información
Conecte su aplicación	Conecte su aplicación para usar tablas de Oracle NoSQL Database Cloud Service.	Conexión de la aplicación a NDCS
Desarrollar una aplicación	Desarrolle su aplicación después de conectarse a las tablas de Oracle NoSQL Database Cloud Service.	Developing in Oracle Cloud Developing in Oracle NoSQL Database Cloud Simulator</p>

Si está configurando Oracle NoSQL Database Cloud Service por primera vez, consulte Configuración del servicio.

Tutoriales de inicio rápido

Acceda a los tutoriales de inicio rápido y empiece a usar el servicio.

Obtenga acceso al servicio.

Regístrese para conseguir una promoción en la nube o adquiere una suscripción a Oracle Cloud. Active su pedido y cree usuarios (opcional). Consulte Configuración del servicio.
Adquiera credenciales para conectar su aplicación. Consulte Autenticación para conectarse a Oracle NoSQL Database.
Cree una tabla en Oracle NoSQL Database Cloud Service. Para empezar, consulte Introducción a las tablas en Oracle NoSQL Database Cloud Service.

Introducción a Oracle NoSQL Database Cloud Service

Enlaces Rápidos

Configuración del servicio

Acceso al servicio desde la consola del Infrastructure

Creación de un compartimiento

Autenticación para conectarse a Oracle NoSQL Database

Conexión de la aplicación a NDCS

Flujo de trabajo típico

Tutoriales de inicio rápido

Temas relacionados