Criar uma conexão do banco de dados

Insights no ArcGIS Enterprise
Insights desktop
Anotação:

Conexões de banco de dados são suportadas no Insights in ArcGIS Enterprise e Insights desktop.

Uma conexão do banco de dados permite a você trabalhar com tabelas do banco de dados diretamente no Insights. As conexões do banco de dados podem ser criadas para bancos de dados suportados e bancos de dados relacionais adicionais que usam um driver do Java Database Connectivity (JDBC) .

Antes de você criar uma conexão do banco de dados, os seguintes pré-requisitos devem ser atendidos:

  • O conector apropriado deve ser adicionado antes de criar uma conexão do banco de dados. Para mais informações, consulteArquivos do fornecedor exigidos e Gerenciar tipos de conectores.
  • Você deve ter os privilégios para o banco de dados apropriado que você deseja conectar. Se você não tiver privilégios do banco de dados, entre em contato com o administrador do bancos de dados.
  • Você deve ser capaz de autenticar a conexão. Para a maioria dos bancos de dados, um nome de usuário e uma senha são usados para autenticação. SQL Server e BigQuery usam os seguintes métodos de autenticação alternativos:

Criar conexões do banco de dados

As conexões de banco de dados são salvas como itens da conexão de banco de dados relacional. Você pode visualizar itens de conexão do banco de dados relacional a partir da guia Conexões na página inicial ou, se tiver usando Insights in ArcGIS Enterprise em seu portal do ArcGIS Enterprise. As conexões podem ser criadas a partir da página inicial ou antes de você adicionar dados ao seu livro de tarefas.

Criar uma conexão a partir da página inicial

Conclua as seguintes etapas para criar uma conexão de banco de dados a partir da página inicial:

  1. Clique na guia Conexões Conexões.
  2. Clique em Nova conexão e escolha Banco de dados no menu.

    A janela Nova conexão aparece.

  3. Escolha o tipo de banco de dados que deseja conectar. Somente os tipos de banco de dados disponíveis para sua organização são listados. Para mais informações, consulte Gerenciar tipos de conectores.
  4. Forneça as propriedades de conexão do seu banco de dados. Os campos exigidos são marcados com um asterisco (*).
  5. Clique em Adicionar.

    O Insights utiliza as propriedades de conexão para tentar conectar ao banco de dados. Após ser bem sucedida, a conexão aparece na página Conexões .

    Se Insights não puder conectar ao banco de dados, uma mensagem de erro aparecerá. Consulte Solucionar problemas de conexão do banco de dados para mais informações sobre as razões que não foi possível estabelecer uma conexão.

Uma conexão de banco de dados relacional é criada. A conexão pode ser atualizada a partir da guia Conexões na página inicial. Para mais informações, consulte Atualizar uma conexão de banco de dados.

Como o proprietário da conexão do banco de dados no Insights in ArcGIS Enterprise, você pode compartilhar o item com membros da equipe, de forma que eles possam utilizar os dados de conexão do banco de dados na sua análise.

Criar uma conexão do partir da janela Adicionar à página

Conclua as seguintes etapas para criar uma conexão do banco de dados a partir da janela Adicionar à página antes que possa adicionar a seu livro de tarefas:

  1. Abra a janela Adicionar à página utilizando uma das seguintes opções:
    • Criar um livro de tarefas. A janela Adicionar à Página aparece quando o livro de tarefas é criado.
    • Clique no botão Adicionar à página Adicionar à página acima do painel de dados em um livro de tarefas existente.
    • Crie uma página em um livro de tarefas existente. A janela Adicionar à Página aparece quando a página é criada.
  2. Na janela Adicionar à página , escolha Banco de Dados.
  3. Clique em Nova Conexão.
  4. Forneça as propriedades de conexão do seu banco de dados. Os campos exigidos são marcados com um asterisco (*).
  5. Clique em OK.

    O Insights utiliza as propriedades de conexão para tentar conectar ao banco de dados. Se a conexão com o banco de dados for possível, a conexão será criada e os conjuntos de dados do banco de dados serão listados no painel central. Você pode escolher conjuntos de dados da sua nova conexão para adicionar à sua página do livro de tarefas.

Uma conexão de banco de dados relacional é criada. A conexão pode ser atualizada a partir da guia Conexões na página inicial. Para mais informações, consulte Atualizar uma conexão de banco de dados.

Como o proprietário da conexão do banco de dados no Insights in ArcGIS Enterprise, você pode compartilhar o item com membros da equipe, de forma que eles possam utilizar os dados de conexão do banco de dados na sua análise.

Propriedades de conexão

As conexões do banco de dados incluem propriedades exigidas e opcionais. As propriedades exigidas são marcadas na janela Nova conexão usando um asterisco (*).

A seguinte tabela descreve as propriedades que são usadas para pelo menos um tipo de banco de dados com suporte.

Anotação:

As propriedades para conexões com bancos de dados adicionais que não estão na lista de bancos de dados com suporte são configuradas nos arquivos YAML (properties.yml) usados para adicionar o tipo de conector. Portanto, as propriedades na janela Nova conexão para bancos de dados adicionais podem não corresponder a propriedades nesta tabela.

PropriedadeDescriçãoBancos de Dados

Nome

O nome alternativo que será atribuído à conexão do banco de dados. A propriedade Name não precisa corresponder ao nome do banco de dados.

Exigido para todos os bancos de dados.

Tipo

O tipo do banco de dados, por exemplo, Oracle ou SQL Server. Somente os conectores que estão disponíveis para sua organização são listados. Para mais informações, consulte Gerenciar tipos de conectores.

Exigido para todos os bancos de dados.

Tipo espacial padrão

O tipo espacial usado quando um campo de localização é adicionado a um conjunto de dados do banco de dados usando a localização habilitada.

Exigido para Oracle e PostgreSQL.

Método de conexão

O método para se conectar a um banco de dados Oracle. O Método de conexão pode ser Básico ou TNS. O método básico cria uma conexão usando um nome de servidor, nome de instância e número de porta. O método TNS cria uma conexão usando um caminho de arquivo TNS e um nome alternativo.

Exigido para Oracle.

Nome do servidor

O nome de host do banco de dados.

Necessário para bancos de dados Oracle usando o método de conexão básico, PostgreSQL, SAP HANA, e bancos de dados SQL Server usando autenticação de SQL Server.

Nome do servidor (Nome de domínio completamente qualificado)

O nome de domínio completamente qualificado de máquina do ArcGIS Server para sua organização.

Exigido para bancos de dados SQL Server usando autenticação de SO ( Windows) .

Nome de instância

A instância do banco de dados ao qual você está conectando.

Necessário para bancos de dados Oracle usando o método de conexão básico. Opcional para SQL Server.

Caminho do arquivo TNS

O caminho onde o arquivo TNS é salvo em seu computador (por exemplo, C:\oracle\network\admin). O caminho não inclui o nome do arquivo TNS (tnsnames.ora).

Necessário para bancos de dados Oracle usando o método de conexão TNS.

Nome alternativo TNS

O nome alternativo no arquivo TNS que define o banco de dados ao qual você está se conectando.

Necessário para bancos de dados Oracle usando o método de conexão TNS.

Número da porta

O número de porta para o banco de dados ao qual você está conectando.

Exigido para SAP HANA. Opcional para bancos de dados Oracle usando o método de conexão básico, PostgreSQL e SQL Server.

Método de autenticação

O método de verificação da conexão do banco de dados. O método de Autenticação pode ser SQL Server ou Windows.

Exigido para SQL Server.

Projetar

O projeto onde seu banco de dados BigQuery é armazenado.

Exigido para BigQuery.

Nome da conta

O nome da conta onde o banco de dados foi salvo.

Exigido para Snowflake.

Domínio ou nome do usuário

O nome de domínio ou nome de usuário que você está usando para autenticar a conexão do banco de dados. Para conexões do SQL Server utilizado autenticação do Windows, utilize um nome de domínio. Para todos os outros bancos de dados e métodos de autenticação, use um nome de usuário.

Exigido para Oracle, PostgreSQL, SAP HANA, Snowflake e SQL Server.

Senha

A senha que corresponde ao nome de usuário que você está usando.

Exigido para os bancos de dados Oracle, PostgreSQL, SAP HANA, Snowflake e SQL Server usando a autenticação de SQL Server .

E-mail da conta de serviço

O endereço de e-mail conectado à sua conta de serviço do Google .

Exigido para BigQuery.

Chave privada

A chave privada para sua conta de serviço do Google.

Exigido para BigQuery.

Conectar utilizando SSL

Habilitar conexão a un banco de dados SAP HANA usando Secure Sockets Layer (SSL).

Opcional para SAP HANA.

Nome do Banco de Dados

O nome do banco de dados ao qual você está conectando.

Exigido para SQL Server, PostgreSQL eSnowflake. Opcional para SAP HANA.

Nome do armazém

O nome do armazém ao qual você está conectando.

Exigido para Snowflake.

Nome do esquema ou Nome do conjunto de dados

O esquema padrão (Snowflake) ou conjunto de dados (BigQuery) para a conexão do banco de dados. Este esquema ou conjunto de dados é usado para armazenar tabelas temporárias criadas durante fluxos de trabalho de análise para conexões de leitura e gravação. Se nenhum esquema ou conjunto de dados for selecionado, ou se o usuário não tiver permissões de leitura e gravação no esquema ou conjunto de dados, a conexão com o banco de dados será somente leitura.

Opcional para Snowflake e BigQuery.

Colunas de índice

O Insights criará um índice em tabelas do banco de dados com determinadas funções usando os bancos de dados Oracle, SQL Server ou PostgreSQL para melhorar o desempenho. Para bancos de dados Oracle e SQL Server , a indexação pode somente acontecer se o usuário que cria a conexão do banco de dados tiver os privilégios do banco de dados exigidos. Após a conexão ser criada, os índices serão criados nas tabelas do banco de dados independente de quem for utilizá-las no Insights.

Se o usuário que cria a conexão do banco de dados não tiver os privilégios necessários, a indexação não acontecerá nas tabelas do banco de dados.

A tabela seguinte descreve como a indexação será executada para cada tipo de banco de dados e os privilégios exigidos para criar uma conexão onde a indexação irá ocorrer:

Banco de DadosDescriçãoTipo de índicePrivilégios exigidos
SAP HANA

A indexação não está concluída no Insights para bancos de dados do SAP HANA.

Não aplicável

Não aplicável

Oracle

A indexação ocorre nas situações seguintes:

  • Um campo é calculado no conjunto de dados.
  • Um relacionamento é criado com o conjunto de dados.
  • Enriquecer Dados é utilizado no conjunto de dados.
  • Localização está habilitada no conjunto de dados, incluindo os resultados da análise espacial.
  • Os dados são projetados para um sistema de coordenadas geográficas diferente. Os dados serão projetados se o sistema de coordenadas do conjunto de dados não corresponder ao sistema de coordenadas do mapa base.

Não único

Conecte e procure o conteúdo com cache de dados.

Um dos seguintes:

  • O usuário é o proprietário da tabela.
  • O proprietário da tabela concedeu o privilégio CREATE INDEX ON <nome da tabela> ao usuário.
SQL Server

A indexação ocorre nas situações seguintes:

  • Um filtro é aplicado ao conjunto de dados.
  • Um relacionamento é criado com o conjunto de dados.
  • Enriquecer Dados é utilizado no conjunto de dados.
  • Localização está habilitada no conjunto de dados, incluindo os resultados da análise espacial.

Não único

Conecte e procure o conteúdo com cache de dados.

PostgreSQL

A indexação ocorre nas situações seguintes:

  • Um filtro é aplicado ao conjunto de dados.
  • Um relacionamento é criado com o conjunto de dados.
  • Um gráfico da série de tempo é criado.

Não único

Conecte e procure o conteúdo com cache de dados.

Snowflake

A indexação não está concluída no Insights para bancos de dados do Snowflake.

Não aplicável

Não aplicável

BigQuery

A indexação não está concluída no Insights para bancos de dados do BigQuery.

Não aplicável

Não aplicável

Tipos espaciais

O tipo espacial padrão é utilizado para determinar qual tipo espacial será utilizado quando um campo de localização for adicionado a um conjunto de dados de banco de dados utilizando habilitar localização. A tabela seguinte descreve os tipos espaciais padrões que estão disponíveis para cada tipo de banco de dados:

Banco de DadosTipos espaciais padrões suportados
SAP HANA
  • ST_Geometry
Oracle
  • Oracle Espacial
  • Geodatabase da Esri
SQL Server
  • Geometria
PostgreSQL
  • Geometria do PostGIS
  • Geodatabase da Esri
  • Nenhum
Snowflake
  • Geografia
BigQuery
  • Geografia
Anotação:

Os tipos espaciais SDELOB não são suportados.

Recursos

Para mais informações sobre como criar e solucionar os problemas dos geodatabases enterprise no Oracle, consulte Geodatabases no Oracle.

Para mais informações sobre como criar e solucionar os problemas dos geodatabases enterprise no Microsoft SQL Server, consulte Geodatabases no Microsoft SQL Server.

Para mais informações sobre como criar e solucionar os problemas dos geodatabases enterprise no PostgreSQL, consulte Geodatabases no PostgreSQL.

Próximas etapas

Agora que você criou uma conexão do banco de dados, você está pronto para compartilhar a conexão com sua organização ou adicionar dados a um livro de tarefas.