Cenário: Conectando seus Dados do IoT ao Analytics Cloud

Configure o acesso para exibir seus dados da Internet of Things (IoT) no Oracle Analytics Cloud.

O esquema do banco de dados do domínio IoT contém os metadados e os dados dos recursos gêmeos digitais associados a um domínio IoT.

1. Na sua tenancy do Internet of Things, faça log-in como administrador.
2. Abra o menu de navegação, selecione Rede e, em seguida, selecione Redes Virtuais em Nuvem.
3. Na página de lista Redes Virtuais na Nuvem, selecione Criar VCN. Se você quiser usar uma VCN existente, para ver VCNs em outro compartimento, selecione um compartimento, ao lado de Filtros aplicados para alterar compartimentos.
4. Informe um nome descritivo para a VCN. Não precisa ser exclusivo e não pode ser alterado posteriormente na Console; você pode alterá-lo posteriormente com a API ou a CLI do domínio de Identidades. Evite digitar informações confidenciais.
5. Verifique o compartimento no qual você deseja criar a VCN e selecione outro compartimento, se necessário.
   Observação
   
   A sua VCN deve estar na mesma região que o grupo de domínios IoT e todos os outros recursos IoT. O limite para o número de VCNs que você pode associar a um domínio IoT é 5.
6. Na seção Blocos IPv4 CIDR, informe uma faixa de IPs que tenha permissão para acessar o banco de dados, por exemplo: 10.0.0.0/16
7. Ative a alternância para usar nomes de host DNS na VCN. Confirme se o label de DNS foi informado no campo abaixo.
8. Confirme ou insira o nome do domínio DNS, por exemplo:

   <vcn-name>.oraclevcn.com

9. Selecione Create a VCN. Para obter uma lista completa de definições adicionais, consulte Criando uma VCN.
10. A página de detalhes Rede Virtual na Nuvem é aberta, com o OCID dessa VCN. Selecione a guia Sub-redes. Selecione Criar Sub-rede.
11. Na página Criar uma Sub-rede, use as seguintes definições:
    1. Informe um nome amigável para a sub-rede. Não precisa ser exclusivo e não pode ser alterado posteriormente na Console; você pode alterá-lo posteriormente com a API do domínio de Identidades. Evite digitar informações confidenciais.
    2. Verifique o compartimento no qual você deseja criar a sub-rede. Selecione outro compartimento, se necessário. Sua Sub-rede e sua VCN devem estar na mesma região que o banco de dados IoT e seus recursos de grupo de domínios e domínio IoT.
    3. Selecione o tipo de sub-rede, Regional. Uma sub-rede regional significa que a sub-rede pode conter recursos em qualquer domínio de disponibilidade da região.
    4. Informe um Bloco IPv4 CIDR, por exemplo, 10.0.0.0/16.
    5. Nos Prefixos IPv6, confirme se o compartimento da Tabela de Roteamento para seus recursos IoT está selecionado. Para a Tabela de Roteamento, selecione a Tabela de Roteamento Padrão para essa VCN.
    6. Selecione o acesso à Sub-rede Privada para proibir o endereço IP público das Instâncias nesta sub-rede.
    7. Em Resolução de DNS, marque a caixa de seleção Usar nomes de host DNS nesta Sub-rede. Confirme se o Label de DNS está no campo a seguir.
    8. Digite o Nome do Domínio DNS com o nome do label DNS da sub-rede, por exemplo:

       <subnet_DNS_label>.<VCN_DNS_label>.oraclevcn.com

    9. Para o compartimento Opções do DHCP, confirme ou selecione o compartimento com seus recursos IoT. Para Opções de Dhcp, confirme ou selecione as Opções de Dhcp Padrão para o nome da VCN.
    10. Para o compartimento da Lista de Segurança, confirme ou selecione o compartimento com seus recursos IoT. Confirme ou informe a Lista de Segurança no próximo campo.
    11. Selecione Criar Sub-rede.

        Para obter uma lista de definições adicionais e mais informações, consulte Criando uma Sub-rede e Visão Geral de VCNs e Sub-redes.

12. A Sub-rede é criada para a Rede Virtual na Nuvem e sua página de detalhes é aberta. Selecione a guia Gateways. Em Gateways de Serviço, selecione Criar Gateway de Serviço.
13. Informe um nome para o gateway de serviço. Ele não precisa ser exclusivo. Evite digitar informações confidenciais. Selecione o compartimento no qual você deseja criar o gateway. Selecione outro compartimento, se necessário. O compartimento deve estar na mesma região que o banco de dados e outros recursos do IoT.
14. Para Serviços, selecione a opção: All <region> Services In Oracle Services Network.

    Para obter mais informações, consulte Labels CIDR de Serviço Disponíveis na página Criando um Gateway de Serviço.

15. Selecione Criar Gateway de Serviço.
16. A página de detalhes Redes virtuais na nuvem é aberta e selecione a guia Roteamento.
17. Em Tabelas de Roteamento, selecione a Tabela de Roteamento Padrão.
18. Selecione a guia Regras de Roteamento e selecione Adicionar Regras de Roteamento para editar e aplicar Regras de Tabela de Roteamento ao Gateway de Serviço. Para obter mais informações, consulte Atualizando as Regras da Tabela de Roteamento de uma VCN ou Atualizando a Associação da Tabela de Roteamento de um Gateway de Serviço para alterar a associação posteriormente.
    • Para Tipo de Destino, selecione Gateway de Serviço.
    • Para Serviço de Destino, selecione Todos os Serviços de <region> no Oracle Services Network .
    • Selecione o Compartimento do Gateway de Serviço de Destino. Selecione o mesmo compartimento selecionado quando você criou o gateway de serviço na etapa anterior.
    • Selecione o Gateway de Serviço de Destino criado na etapa anterior. Como opção, insira uma descrição.
    • Selecione Adicionar Regras de Roteamento.
    Para obter mais informações, consulte adicionar uma regra de roteamento.
19. A Regra de Roteamento é criada e exibida na página da lista Regra de Roteamento.
20. Vá para a página de detalhes da Rede Virtual na Nuvem da VCN. Se precisar de ajuda para localizar a VCN, consulte Listando VCNs e selecione a VCN com a qual você deseja trabalhar.
21. Selecione a tab Segurançca. A página Lista de Segurança é aberta. Para obter mais informações, consulte Creating an Network Security Group (NSG).
22. Vá para a seção Network Security Groups. Em Recursos, selecione Grupos de Segurança de Rede.
23. Selecione Criar Grupo de Segurança de Rede e informe as seguintes definições:
    • Digite um nome e selecione o mesmo compartimento que você selecionou na etapa anterior.
    • Na seção Rule, para a Direção, selecione Egress.
    • Para o Tipo de Destino, selecione CIDR.
    • No campo CIDR de Destino, informe o CIDR do seu ambiente, por exemplo: 0.0.0.0/0
    • Para Protocolos IP, selecione Todos os Protocolos.
24. Selecione Criar. Para obter mais informações, consulte Grupo de Segurança de Rede,
25. A página Segurança de Rede é aberta para exibir os detalhes do Grupo de Segurança de Rede.
26. Na página de detalhes Rede virtual na nuvem, copie o OCID da VCN ou das VCNs. Use este OCID de VCN ou OCIDs de VCN na próxima etapa.

oci iot domain-group configure-data-access --db-allow-listed-vcn-ids '["vcn-OCID-1","vcn-OCID-2"]' --iot-domain-group-id <domain-group-OCID>

oci iot domain-group get --iot-domain-group-id <iot-domain-group-OCID>

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "<domain-group-short-id>.iot-data.<region>.oci.oraclecloud.com",
    "db-allow-listed-vcn-ids": [
      "<vcn-OCID>"
    ],
    "db-connection-string": "tcps:adb.<region>.oraclecloud.com:<port>/<unique-id>.adb.oraclecloud.com?retry_count=20&retry_delay=3",
    "db-token-scope": "urn:oracle:db::id::ocid1.<database-compartment-OCID>",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-11T19:21:24.791Z"
      }
    },
    "description": "<your-description>",
    "display-name": "<your-display-name>",
    "freeform-tags": {},
    "id": "<domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-08-11T19:21:26.411000+00:00",
    "time-updated": "2025-08-12T02:17:02.763000+00:00"
  },
  "etag": "<unique-id>"
}

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID:<identity-domain-name>/<identity-group-name>"]'

1. Na página Detalhes da Instância do Analytics Cloud, em Informações de Acesso, selecione o URL de Acesso do OAC para ir para o Oracle Analytics Cloud. Selecione Criar e depois Conexão.
2. Selecione o banco de dados do Oracle Autonomous Transaction Processing. Especifique as informações a seguir para o grupo de domínios IoT específico. Use o comando oci iot domain-group get para localizar os valores específicos do seu grupo de domínios IoT, descritos na etapa anterior:
   • Nome da Conexão: Informe um nome para esta conexão.
   • Descrição: (Opcional) Informe uma descrição.
   • Tipo de Criptografia: TLS
   • String de Conexão: Use a seguinte string de conexão e substitua os valores do seu grupo de domínios IoT específico. Por exemplo:

     • Substitua o <database-service-name> pelo banco de dados do db-connection-string do seu grupo de domínios IoT.

       <unique-id>.adb.oraclecloud.com

     • Substitua o <user-tenancy-OCID> pelo OCID da sua tenancy em que você criou o domínio IoT e o Oracle Analytics Cloud está localizado.
     • Substitua o <database-compartment-OCID> do db-token-scope
     • Substitua a <region> pelo nome da sua região que deve estar na mesma região que a <database-hostname>. Por exemplo: us-phoenix-1
     String de conexão:

     (description=
       (retry_count=20)
       (retry_delay=3)
       (address=
         (protocol=tcps)
         (port=1521)
         (host=<database-host-name>)
       )
       (connect_data=(service_name=<database-service-name>))
       (security=
         (ssl_server_dn_match=yes)
         (password_auth=OCI_TOKEN)
         (oci_iam_url=https://auth.<region>.oraclecloud.com/v1/actions/generateScopedAccessBearerToken)
         (oci_tenancy=<user-tenancy-OCID>)
         (oci_compartment=<database-compartment-OCID>)
       )
     )

   • Nome do Usuário: Informe o usuário e o grupo do domínio de Identidades configurados na etapa anterior.
     • Um <identity-group-name> é o grupo de usuários de Identidades ou um grupo dinâmico de Identidades.
     • Se não estiver no domínio de identidades padrão, você especificará o domínio de identidades e o nome do grupo: <identity-domain-name>/<identity-group-name>
   • Senha: Informe a senha do banco de dados para o usuário ou grupo do domínio de Identidades. Para alterar a senha do banco de dados:
     1. Abra o menu de navegação, vá para Identity & Management e selecione domínios.
     2. Na página da lista de domínios, selecione o Domínio de identidades com o qual você deseja trabalhar e estabeleça conexão com um domínio IoT.
     3. Selecione a guia Gerenciamento de Usuários, selecione o usuário cujo nome de usuário você deseja atualizar. Selecione a guia Senhas do Banco de Dados para atualizar a senha excluir sua senha atual do banco de dados do IAM e criar uma nova senha do banco de dados do IAM.
3. Selecione Salvar.

4. Agora, você pode exibir seus dados do IoT no Oracle Analytics Cloud.

   Na home page do Analytics Cloud, clique em Criar, depois clique em Conjunto de Dados e selecione a conexão que você acabou de criar para exibir e analisar seus dados do IoT no Analytics Cloud.

   Clique com o botão direito do mouse e selecione abrir em um novo navegador para ver uma captura de tela maior.