Conceitos Básicos do Oracle NoSQL Database Cloud Service

Links rápidos

Você pode começar a usar o Oracle NoSQL Database Service em um dos links rápidos abaixo:

Tabela - Links Rápidos


Comece a Trabalhar Início Rápido: Conceitos Básicos Principais Recursos Conceitos do Cloud Preços	Conectar Adquira suas Credenciais Autenticação para conexão com o NDCS Conectando seu Aplicativo ao NDCS regiões de dados e pontos finais de serviço associados	IDE e SDKs Usando o Plug-in IntelliJ para Desenvolvimento Usando a Extensão de Código do Visual Studio para Desenvolvimento Oracle NoSQL Java SDK SDK para Python do Oracle NoSQL SDK DO Oracle NoSQL GO SDK do Oracle NoSQL Node.js SDK de Dotnet do Oracle NoSQL
Create Tables Criando uma Tabela Usando a Console para criar Tabelas Únicas Usando APIs para criar Tabelas Singleton Tabelas Ativas Globais Usando a console para criar uma Tabela Ativa Global Usando APIs para criar uma Tabela Ativa Global Usando o OCI cli para criar uma tabela	Colocar e Explorar Dados Usando a Console para adicionar dados Usando APIs para adicionar dados Usando a Console para extrair dados Usando Obter API para extrair dados Usando a API de Consulta para extrair dados Consultando tabelas pai-filho	Manage Tables Modificando Tabelas Singleton Usando APIs Modificando Tabelas Ativas Globais Usando APIs Eliminando Tabelas e Índices Gerenciando Tabelas e Índices com a Console
Gerenciar Segurança Configurar Grupos de Usuários e Políticas Permitindo a Outro Usuário Gerenciar Tabelas NoSQL Referência da Política	Monitorar o Serviço Eventos de Serviço Cotas de Serviço Métricas Criar e Gerenciar Alarmes	Utilitários Fazer download do Oracle NoSQL Database Cloud Simulator Desenvolvendo no Oracle NoSQL Database Cloud Simulator Usando o Oracle NoSQL Database Migrator Usando o Oracle NoSQL Database Analytics Integrator
Referência SQL Usando Operadores no SQL Organizando e Limitando Dados Usando Expressões Primárias em SQL Usando funções de Timestamp em consultas Usando funções String em consultas	Guias de referência Referência do Analytics Integrator Amostra de casos de uso para NDCS Solucionar problemas com o GAT

Configurando o Seu Serviço

Se você estiver configurando o Oracle NoSQL Database Cloud Service pela primeira vez, siga essas tarefas para guiá-lo.

Tarefa	Reference	Informações Relacionadas
Faça um pedido do Oracle NoSQL Database Cloud Service ou registre-se na Avaliação Grátis do Oracle.	Inscrevendo-se no Oracle Cloud Infrastructure na Documentação do Oracle Cloud Infrastructure.	Para saber como estimar o custo mensal da sua assinatura do Oracle NoSQL Database Cloud Service, consulte Estimando o Seu Custo Mensal. Para atualizar sua conta grátis ou alterar seu método de pagamento, consulte Alterando seu Método de Pagamento na Documentação do Oracle Cloud Infrastructure.
Ativar sua conta do Oracle Cloud e acessar pela primeira vez.	Entrando na Console na Documentação do Oracle Cloud Infrastructure.	Para se familiarizar com a Console de Infraestrutura do Oracle Cloud, consulte Usando a Console na Documentação do Oracle Cloud Infrastructure.
(Recomendado) Crie um compartimento para o seu serviço.	Criando um Compartimento	Se você não estiver familiarizado com compartimentos, consulte Understanding Compartments na Documentação do Oracle Cloud Infrastructure.
Gerencie a segurança do seu serviço.	Sobre o Modelo de Segurança do Oracle NoSQL Database Cloud Service	Para se familiarizar com o modelo de segurança do NoSQL Database Cloud Service, consulte Sobre o Modelo de Segurança do Oracle NoSQL Database Cloud Service.

Acessando o Serviço na Console de Infraestrutura

Saiba como acessar o serviço Oracle NoSQL Database Cloud Service na Console de Infraestrutura.

Localize o URL do serviço no e-mail de boas-vindas. Em seguida, acesse o Oracle NoSQL Database Cloud Service.
Abra o menu de navegação, clique em Bancos de Dados e, em seguida, clique em NoSQL Banco de Dados.
Selecione o compartimento criado para as suas tabelas pelo administrador do serviço.

Para exibir a ajuda da página atual, clique no ícone de ajuda

, localizado na parte superior da página.

Criando um Compartimento

Quando você se inscreve no Oracle Cloud Infrastructure, a Oracle cria sua tenancy com um compartimento raiz que contém todos os seus recursos de nuvem. Em seguida, você cria compartimentos adicionais na tenancy (compartimento-raiz) e políticas correspondentes para controlar o acesso aos recursos em cada compartimento. Antes de criar uma tabela do Oracle NoSQL Database Cloud Service, a Oracle recomenda configurar o compartimento ao qual a tabela deverá pertencer.

Você cria compartimentos no Oracle Cloud Infrastructure Identity and Access Management (IAM). Consulte Configurando sua Tenancy e Gerenciando Compartimentos na Documentação do Oracle Cloud Infrastructure.

Autenticação para estabelecer conexão com o Oracle NoSQL Database

Você precisa de uma conta do Oracle Cloud para conectar o seu aplicativo com o Oracle NoSQL Database Cloud Service.

Se você ainda não tiver uma conta do Oracle Cloud, poderá começar pelo Oracle Cloud. Você precisa se autenticar ao estabelecer conexão com o Oracle NoSQL Database. Você pode ser autenticado usando uma das seguintes maneiras:

Método de autenticação no 1: Controlador de usuários

Aqui você usa um usuário do OCI e uma chave de API para autenticação. As credenciais usadas para conectar o seu aplicativo são associadas a um usuário específico. Se quiser criar um usuário para o seu aplicativo, consulte Configurando Usuários, Grupos e Políticas Usando o Identity and Access Management.

Você pode fornecer suas credenciais para este método de autenticação usando uma das seguintes maneiras:

Usando um arquivo em um disco local, o arquivo contém detalhes como OCID do usuário, OCID da tenancy, região, caminho da chave privada e impressão digital. Você pode usar isso se estiver trabalhando em uma rede segura e o armazenamento de chaves privadas e configurações localmente estiver em conformidade com suas políticas de segurança.
Fornecer as credenciais por meio de uma API.
Armazenando as credenciais em um vault em algum lugar.

Informações sobre as Credenciais:

Tabela - Credenciais

O que é?	Onde encontro?
ID da Tenancy e ID do Usuário (ambos são OCID )	Consulte Para Obter o OCID da Tenancy e o OCID do Usuário na Documentação do Oracle Cloud Infrastructure.
Chave de Assinatura de API	Para o usuário do aplicativo, uma chave de assinatura da API deve ser gerada e carregada. Se isso já tiver sido feito, esta etapa poderá ser ignorada. Para saber mais, consulte os seguintes recursos na Documentação do Oracle Cloud Infrastructure: Como Gerar uma Chave de Assinatura da API para gerar a chave de assinatura com uma senha opcional. Como Fazer o Upload da Chave Pública para fazer o upload da chave de assinatura da API para a conta do usuário.
Impressão Digital da Chave de Assinatura e da Frase-Senha (Opcional) da Chave de Assinatura	A impressão digital e a senha da chave de assinatura são criadas durante a geração e o upload da Chave de Assinatura da API. Consulte Como Obter a Impressão Digital da Chave na Documentação do Oracle Cloud Infrastructure.

Dica:

Faça uma anotação da localização da sua chave privada, da frase-senha opcional e da impressão digital da chave pública ao gerar e fazer o upload da Chave de Assinatura da API.

Após executar as tarefas discutidas acima, colete as informações de credenciais e forneça para o seu aplicativo.

Fornecendo as Credenciais para o seu Aplicativo:

Os SDKs do Oracle NoSQL Database permitem que você forneça as credenciais para um aplicativo de várias maneiras. Os SDKs suportam um arquivo de configuração e também uma ou mais interfaces que permitem a especificação direta das informações. Consulte a documentação do driver da linguagem de programação que você está usando para obter mais informações sobre as interfaces de credenciais específicas.

Se você estiver usando um arquivo de configuração, a localização padrão será ~/.oci/config. Os SDKs permitem que o arquivo resida em locais alternativos. Seu conteúdo é semelhante a este:

[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

A linha [DEFAULT] indica que as linhas a seguir especificam o perfil DEFAULT. Um arquivo de configuração pode incluir vários perfis, prefixados com [PROFILE_NAME]. Por exemplo:

[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 Autenticação no 2: Controladores de Instância

Controlador de Instâncias é um recurso do Oracle Cloud Infrastructure Identity and Access Management (IAM) que permite fazer chamadas de serviço de uma instância. Com os principais de instâncias, você não precisa configurar credenciais de usuário para os serviços em execução em suas instâncias de computação nem rotacionar as credenciais. As próprias instâncias agora são um tipo de principal no IAM. Cada instância de computação tem sua própria identidade e faz a autenticação usando certificados que são adicionados à instância. Esses certificados são criados, designados a instâncias e rotacionados automaticamente.

Usando a autenticação do controlador de instâncias, você pode autorizar uma instância a fazer chamadas de API nos serviços do Oracle Cloud Infrastructure. Após configurar os recursos e as políticas obrigatórias, um aplicativo que esteja em execução em uma instância pode chamar serviços públicos do Oracle Cloud Infrastructure, removendo a necessidade de configurar credenciais do usuário ou um arquivo de configuração. A autenticação do controlador de instâncias pode ser usada em uma instância na qual você não deseja armazenar um arquivo de configuração.

Método de Autenticação no 3: Controladores de Recursos

Você pode usar um controlador de recursos para autenticar e acessar recursos do Oracle Cloud Infrastructure. O controlador de recursos consiste em um token de sessão temporário e credenciais seguras que permitem que outros serviços do Oracle Cloud se autentiquem no Oracle NoSQL Database. A autenticação do controlador de recursos é muito semelhante à autenticação do controlador de instâncias, mas destina-se a ser usada para recursos que não são instâncias, como funções sem servidor.

Um principal de recursos permite que os recursos sejam autorizados a executar ações nos serviços do Oracle Cloud Infrastructure. Cada recurso tem sua própria identidade, e o recurso faz a autenticação usando os certificados que são adicionados a ele. Esses certificados são criados, designados aos recursos e rotacionados automaticamente, evitando a necessidade de criar e gerenciar suas próprias credenciais para acessar o recurso. Quando você faz a autenticação usando um controlador de recursos, não é necessário criar e gerenciar credenciais para acessar os recursos do Oracle Cloud Infrastructure.

Depois de autenticado, você precisa estar autorizado a acessar os recursos do Oracle Cloud Infrastructure. Consulte Configurando Usuários, Grupos e Políticas com o Serviço Identity and Access Management para obter mais detalhes.

Conectando seu Aplicativo ao NDCS

Saiba como conectar o seu aplicativo com o Oracle NoSQL Database Cloud Service.

Seu aplicativo se conecta ao Oracle NoSQL Database Cloud Service depois de ser autenticado usando um dos muitos métodos disponíveis.

Você pode ser autenticado usando um dos seguintes:

chave de assinatura de API
- De qualquer programa SDK (Java, Python, C#, GO, Node.js) codificado diretamente
- Um arquivo de configuração com um perfil padrão
- Um arquivo de configuração com um perfil não padrão
Controlador de Instâncias com tokens de Autenticação
Controlador de Recursos

Consulte Autenticação para estabelecer conexão com o Oracle NoSQL Database para obter mais detalhes sobre as opções de autenticação.

Você pode se conectar ao NDCS usando um dos seguintes métodos:

Fornecimento direto de credenciais no 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.

Estabelecendo Conexão Usando um Arquivo de Configuração com um perfil padrão:

/* 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();

Conectando usando um arquivo de configuração com perfil não padrão:

/* Use the SignatureProvider to supply your credentials to NoSQL Database. 
* Specify the full location of the configuration file in the construtor for SignatureProvider. 
*/
final String config_file = "<path_to_config_file>";
SignatureProvider sp = new SignatureProvider(config_file);

Estabelecendo Conexão com um Controlador de Instâncias:
Controlador de Instâncias é um recurso do serviço IAM que permite que instâncias sejam atores autorizados (ou principais) para executar ações em recursos do serviço. Cada instância de computação tem sua própria identidade e faz a autenticação usando os certificados que são adicionados a ela.
```
SignatureProvider authProvider = SignatureProvider.createWithInstancePrincipal();
```
Estabelecendo Conexão usando um Controlador de Recursos:
O Controlador de Recursos é um recurso do serviço IAM que permite que os recursos sejam atores autorizados (ou principais) para executar ações nos recursos do serviço.
```
SignatureProvider authProvider = SignatureProvider.createWithResourcePrincipal();
```

Consulte SignatureProvider para obter mais detalhes sobre as classes Java usadas.

Você pode se conectar ao NDCS usando um dos seguintes métodos:

Fornecimento direto de credenciais no 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')

Estabelecendo Conexão Usando um Arquivo de Configuração com um perfil padrão:

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

Conectando usando um arquivo de configuração com perfil não padrão:

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

Conexão usando um Controlador de Instâncias:
Controlador de Instâncias é um recurso do serviço IAM que permite que instâncias sejam atores autorizados (ou principais) para executar ações em recursos do serviço. Cada instância de computação tem sua própria identidade e faz a autenticação usando os certificados que são adicionados a ela.
```
at_provider =
SignatureProvider.create_with_instance_principal(region=my_region)
```
Estabelecendo Conexão usando um Controlador de Recursos:
O Controlador de Recursos é um recurso do serviço IAM que permite que os recursos sejam atores autorizados (ou principais) para executar ações nos recursos do serviço.
```
at_provider = SignatureProvider.create_with_resource_principal()
```

Você pode conectar seu aplicativo ao NDCS usando qualquer um dos seguintes métodos:

Fornecimento direto de credenciais no 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>",
}

Estabelecendo Conexão Usando um Arquivo de Configuração com um perfil padrão:

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)

Conectando usando um arquivo de configuração com perfil não padrão:

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)

Conexão usando um Controlador de Instâncias:
Controlador de Instâncias é um recurso do serviço IAM que permite que instâncias sejam atores autorizados (ou principais) para executar ações em recursos do serviço. Cada instância de computação tem sua própria identidade e faz a autenticação usando os certificados que são adicionados a ela.
```
sp, err := iam.NewSignatureProviderWithInstancePrincipal("compartment_id")
if err != nil {
    return
}
cfg := nosqldb.Config{
    AuthorizationProvider: sp,
    Region: "<your-service-region>",
}
client, err := nosqldb.NewClient(cfg)
```

Estabelecendo Conexão usando um Controlador de Recursos:

O Controlador de Recursos é um recurso do serviço IAM que permite que os recursos sejam atores autorizados (ou principais) para executar ações nos recursos do serviço.

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

Você pode se conectar ao NDCS usando um dos seguintes métodos:

Fornecimento direto de credenciais no código:

Você pode especificar credenciais diretamente como parte da propriedade auth.iam na configuração inicial. Crie a instância NoSQLClient da seguinte forma:

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
        }
    }
});

Estabelecendo Conexão Usando um Arquivo de Configuração com um perfil padrão:

Você pode armazenar as credenciais em um arquivo de configuração do Oracle Cloud Infrastructure. O caminho padrão do arquivo de configuração é ~/.oci/config, em que ~ significa o diretório home do usuário. No Windows, ~ é um valor da variável de ambiente USERPROFILE. O arquivo pode conter vários perfis. Por padrão, o SDK usa o perfil DEFAULT para armazenar as credenciais.
Para usar esses valores padrão, crie o arquivo nomeado config no diretório ~/.oci com o seguinte conteúdo:
```
[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>
```
Observe que você também pode especificar seu identificador de região juntamente com credenciais no arquivo de configuração do OCI. O driver examinará o local acima por padrão e, se uma região for fornecida juntamente com credenciais, você não precisará fornecer a configuração inicial e poderá usar o construtor sem argumento:
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient();
```
Como alternativa, você pode optar por especificar a região na configuração:
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient({ region: Region.<your-service-region> });
```
Conectando usando um arquivo de configuração com perfil não padrão:

Você pode optar por usar um caminho diferente para o arquivo de configuração do OCI, bem como um perfil diferente dentro do arquivo de configuração. Nesse caso, especifique-os na propriedade auth.iam da configuração inicial. Por exemplo, se o caminho do arquivo de configuração do OCI for ~/myapp/.oci/config e você armazenar suas credenciais no perfil Jane:
Em seguida, crie a instância NoSQLClient da seguinte 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>'
        }
    }
});
```
Conexão usando um Controlador de Instâncias:

Controlador de Instâncias é um recurso do serviço IAM que permite que instâncias sejam atores autorizados (ou principais) para executar ações em recursos do serviço. Cada instância de computação tem sua própria identidade e faz a autenticação usando os certificados que são adicionados a ela.
Depois de configurada, crie a instância NoSQLClient da seguinte forma:
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
const client = new NoSQLClient({
    region: Region.<your-service-region>,
    compartment: 'ocid1.compartment.oc1..............'
    auth: {
        iam: {
            useInstancePrincipal: true
        }
    }
});
```
Você também pode usar o arquivo de configuração JSON com a mesma configuração descrita acima. Observe que ao usar o Controlador de Instâncias, você deve especificar o id do compartimento (OCID) como propriedade do compartimento. Isso é necessário mesmo que você queira usar o compartimento padrão. Observe que você deve usar o id do compartimento e não o nome ou o caminho do compartimento. Além disso, ao usar o Controlador de Instâncias, você não pode prefixar o nome da tabela com o nome ou o caminho do compartimento ao chamar APIs NoSQLClient.
Estabelecendo Conexão usando um Controlador de Recursos:

O Controlador de Recursos é um recurso do serviço IAM que permite que os recursos sejam atores autorizados (ou principais) para executar ações nos recursos do serviço.
Depois de configurada, crie a instância NoSQLClient da seguinte forma:
```
import { NoSQLClient, Region } from 'oracle-nosqldb';
const client = new NoSQLClient({
    region: Region.<your-service-region>,
    compartment: 'ocid1.compartment.oc1...........................'
    auth: {
        iam: {
            useResourcePrincipal: true
        }
    }
});
```
Você também pode usar o arquivo de configuração JSON com a mesma configuração descrita acima. Observe que ao usar o Controlador de Recursos, você deve especificar o id do compartimento (OCID) como propriedade do compartimento. Isso é necessário mesmo que você queira usar o compartimento padrão. Observe que você deve usar o id do compartimento e não o nome ou o caminho do compartimento. Além disso, ao usar o Controlador de Recursos, você não pode prefixar o nome da tabela com o nome ou o caminho do compartimento ao chamar APIs NoSQLClient.

Você pode se conectar ao NDCS usando um dos seguintes métodos:

Fornecimento direto de credenciais no código:

Você pode especificar credenciais diretamente como IAMCredentials ao criar IAMAuthorizationProvider. Crie NoSQLClient da seguinte forma:

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

Estabelecendo Conexão Usando um Arquivo de Configuração com um perfil padrão:

Você pode armazenar as credenciais em um arquivo de configuração do Oracle Cloud Infrastructure. O caminho padrão do arquivo de configuração é ~/.oci/config, em que ~ significa o diretório home do usuário. No Windows, ~ é um valor da variável de ambiente USERPROFILE. O arquivo pode conter vários perfis. Por padrão, o SDK usa o perfil DEFAULT para armazenar as credenciais
Para usar esses valores padrão, crie o arquivo chamado config no diretório ~/.oci com o seguinte conteúdo:
```
[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>
```
Observe que você também pode especificar seu identificador de região juntamente com credenciais no arquivo de configuração do OCI. Por padrão, o driver procurará credenciais e uma região no arquivo de configuração do OCI no caminho padrão e no perfil padrão. Portanto, se você fornecer a região juntamente com credenciais, conforme mostrado acima, poderá criar a instância NoSQLClient sem especificar nenhuma configuração:
```
var client = new NoSQLClient();
```
Como alternativa, você pode especificar a região (assim como outras propriedades) em NoSQLConfig:
```
var client = new NoSQLClient(
    new NoSQLConfig(
    {
        Region = Region.<your-service-region>,
        Timeout = TimeSpan.FromSeconds(10),
    });
```
Conectando usando um arquivo de configuração com perfil não padrão:

Você pode optar por usar um caminho diferente para o arquivo de configuração do OCI, bem como um perfil diferente dentro do arquivo de configuração. Nesse caso, especifique-os na propriedade auth.iam da configuração inicial. Por exemplo, se o caminho do arquivo de configuração do OCI for ~/myapp/.oci/config e você armazenar suas credenciais no perfil Jane:
Em seguida, crie a instância NoSQLClient da seguinte forma:
```
var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region = Region.<your-service-region>,
        AuthorizationProvider = new IAMAuthorizationProvider(
            "<your_config_file>", "<your_profile_name>")
    });
```
Conexão usando um Controlador de Instâncias:
Controlador de Instâncias é um recurso do serviço IAM que permite que instâncias sejam atores autorizados (ou principais) para executar ações em recursos do serviço. Cada instância de computação tem sua própria identidade e faz a autenticação usando os certificados que são adicionados a ela. Depois de configurada, crie a instância NoSQLClient da seguinte forma:
```
var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region=<your-service-region>,
        Compartment="ocid1.compartment.oc1.............................",
        AuthorizationProvider=IAMAuthorizationProvider.CreateWithInstancePrincipal()
    });
```
Você também pode representar a mesma configuração em JSON da seguinte forma:
```
{
    "Region": "<your-service-region>",
    "AuthorizationProvider":
    {
        "AuthorizationType": "IAM",
        "UseInstancePrincipal": true
    },
    "Compartment": "ocid1.compartment.oc1.............................",
}
```
Observe que ao usar o Controlador de Instâncias, você deve especificar o id do compartimento (OCID) como propriedade compartimento. Isso é necessário mesmo que você queira usar o compartimento padrão. Observe que você deve usar o id do compartimento e não o nome ou o caminho do compartimento. Além disso, ao usar o Controlador de Instâncias, você não pode prefixar o nome da tabela com o nome ou o caminho do compartimento ao chamar APIs NoSQLClient.
Estabelecendo Conexão usando um Controlador de Recursos:
O Controlador de Recursos é um recurso do serviço IAM que permite que os recursos sejam atores autorizados (ou principais) para executar ações nos recursos do serviço. Depois de configurada, crie a instância NoSQLClient da seguinte forma:
```
var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region = <your-service-region>,
        Compartment =
            "ocid1.compartment.oc1.............................",
        AuthorizationProvider =
            IAMAuthorizationProvider.CreateWithResourcePrincipal()
    });
```
Você também pode representar a mesma configuração em JSON da seguinte forma:
```
{
    "Region": "<your-service-region>",
    "AuthorizationProvider":
    {
        "AuthorizationType": "IAM",
        "UseResourcePrincipal": true
    },
    "Compartment": "ocid1.compartment.oc1.............................",
}
```
Observe que ao usar o Controlador de Recursos, você deve especificar o id do compartimento (OCID) como propriedade compartimento. Isso é necessário mesmo que você queira usar o compartimento padrão. Observe que você deve usar o id do compartimento e não o nome ou o caminho do compartimento. Além disso, ao usar o Controlador de Recursos, você não pode prefixar o nome da tabela com o nome ou o caminho do compartimento ao chamar APIs NoSQLClient.

Workflow Típico

Sequência típica de tarefas para trabalhar com o Oracle NoSQL Database Cloud Service.

Se você estiver desenvolvendo aplicativos usando o Oracle NoSQL Database Cloud Service pela primeira vez, siga essas tarefas para guiar.

Tarefa	Descrição	Mais informações
Conecte seu aplicativo	Conecte o seu aplicativo para usar tabelas do Oracle NoSQL Database Cloud Service.	Conectando seu Aplicativo ao NDCS
Desenvolver o seu aplicativo	Desenvolva o seu aplicativo conectando-se com as tabelas do Oracle NoSQL Database Cloud Service.	Desenvolvendo no Oracle Cloud Desenvolvendo no Oracle NoSQL Database Cloud Simulator

Se você estiver configurando o Oracle NoSQL Database Cloud Service pela primeira vez, consulte Configurando o Seu Serviço.

Tutoriais de Início Rápido

Acesse os tutoriais de início rápido e comece a usar o serviço.

Obtenha acesso ao serviço.

Inscreva-se em uma promoção do Cloud ou adquira uma assinatura do Oracle Cloud. Ative seu pedido, crie usuários (opcional). Consulte Configurando o Serviço.
Obtenha credenciais para conectar o seu aplicativo. Consulte Autenticação para estabelecer conexão com o Oracle NoSQL Database.
Crie uma tabela no Oracle NoSQL Database Cloud Service.
- Para começar, consulte Conceitos Básicos de Tabelas no Oracle NoSQL Database Cloud Service.