创建数据库连接

Insights in ArcGIS Enterprise
Insights 桌面版
注:

Insights in ArcGIS EnterpriseInsights desktop 不支持数据库连接。

数据库连接允许您直接在 Insights 中使用数据库表。 可以创建与受支持的数据库和使用 Java Database Connectivity (JDBC) 驱动程序的其他关系数据库之间的数据库连接。

创建数据库连接前,必须满足以下先决条件:

  • 必须先添加适当的连接器,然后才能创建数据库连接。 有关详细信息,请参阅所需供应商文件管理连接器类型
  • 必须具有要连接到的数据库的相应权限。 如果您没有数据库权限,请联系数据库管理员。
  • 您必须能够验证连接。 对于大多数数据库,可以使用用户名和密码进行身份验证。 SQL ServerBigQuery 将使用以下替代身份验证方法:
    • SQL Server 可以使用 SQL Server 身份验证(用户名和密码)或 OS 身份验证。 有关详细信息,请参阅启用 OS 身份验证
    • BigQuery 将使用服务帐户身份验证。 有关详细信息,请参阅创建服务帐户和私钥

创建数据库连接

数据库连接将被保存为关系数据库连接项目。 您可以通过主页连接选项卡或在 ArcGIS Enterprise 门户中(如果您正在使用 Insights in ArcGIS Enterprise)查看关系数据库连接项。 可以通过主页或在向工作簿添加数据之前创建连接。

在主页中创建连接

要从主页创建数据库连接,请完成以下步骤:

  1. 单击连接选项卡 连接
  2. 单击新建连接,然后从菜单中选择数据库

    随即显示新建连接窗口。

  3. 选择您要连接的数据库类型。 仅列出可用于组织的数据库类型。 有关详细信息,请参阅管理连接器类型
  4. 为您的数据库提供连接属性。 必填字段将用星号 (*) 标记。
  5. 单击添加

    Insights 使用连接属性尝试连接数据库。 成功后,连接将显示在连接页面。

    如果 Insights 无法连接到数据库,则将显示错误消息。 有关无法建立连接的原因的详细信息,请参阅数据库连接疑难解答

将创建关系数据库连接。 可以通过主页上的连接选项卡更新连接。 有关详细信息,请参阅更新数据库连接

您作为 Insights in ArcGIS Enterprise 中数据库连接的所有者,可以与团队成员共享项目,以便团队成员在其分析中使用数据库连接中的数据。

从“添加到页面”窗口中创建连接

将数据添加至工作簿之前,要从添加至页面窗口中创建数据库连接,请完成以下步骤:

  1. 使用以下选项之一打开添加到页面窗口:
    • 创建工作簿。 创建工作簿后,随即显示添加到页面窗口。
    • 单击现有工作簿数据窗格上方的添加到页面按钮 添加到页面
    • 将在现有工作簿中创建页面。 页面创建后,随即显示添加到页面窗口。
  2. 添加到页面窗口中,选择数据库
  3. 单击新建连接
  4. 为您的数据库提供连接属性。 必填字段将用星号 (*) 标记。
  5. 单击确定

    Insights 使用连接属性尝试连接数据库。 如果连接数据库可行,则将创建连接,并在中间窗格中列出数据库的数据集。 可以从新连接选择数据集以添加到工作簿页面。

将创建关系数据库连接。 可以通过主页上的连接选项卡更新连接。 有关详细信息,请参阅更新数据库连接

您作为 Insights in ArcGIS Enterprise 中数据库连接的所有者,可以与团队成员共享项目,以便团队成员在其分析中使用数据库连接中的数据。

连接属性

数据库连接同时包含必选属性和可选属性。 必选属性在新建连接窗口中使用星号 (*) 进行标记。

下表描述了至少用于一种受支持的数据库类型的属性。

注:

对于未包含在受支持数据库列表中的其他数据库,将在用于添加连接器类型的 YAML 文件 (properties.yml) 中配置这些数据库连接的属性。 因此,其他数据库的新建连接窗口中的属性可能与该表中的属性不对应。

属性描述数据库

名称

将被分配给数据库连接的别名。 名称属性不必与数据库名称相对应。

对于所有数据库,此为必填项。

类型

数据库类型,例如 OracleSQL Server。 仅列出可用于组织的连接器。 有关详细信息,请参阅管理连接器类型

对于所有数据库,此为必填项。

默认空间类型

使用启用位置将位置字段添加到数据库数据集时所用的空间类型

对于 OraclePostgreSQL,此为必填项。

连接方法

连接到 Oracle 数据库的方法。 连接方法可以是基本TNS。 基本方法使用服务器名称、实例名称和端口号创建连接。 TNS 方法使用 TNS 文件路径和别名创建连接。

对于 Oracle,此为必填项。

服务器名称

数据库主机名。

对于使用基本连接方法的 Oracle 数据库、PostgreSQLSAP HANA 和使用 SQL Server 身份验证的 SQL Server 数据库,此为必填项。

服务器名称(完全限定域名)

您组织的 ArcGIS Server 计算机上的完全限定域名。

对于使用 OS (Windows) 身份验证的 SQL Server 数据库,此为必填项。

实例名称

您要连接的数据库的实例。

对于使用基本连接方法的 Oracle 数据库,此为必填项。 对于 SQL Server,此为可选项。

TNS 文件路径

TNS 文件在您的计算机上的保存路径(例如 C:\oracle\network\admin)。 路径不包括 TNS 文件名称 (tnsnames.ora)。

对于使用 TNS 连接方法的 Oracle 数据库,此为必填项。

TNS 别名

TNS 文件中的别名,定义要连接到的数据库。

对于使用 TNS 连接方法的 Oracle 数据库,此为必填项。

端口号

您要连接的数据库的端口号。

对于 SAP HANA,此为必填项。 对于使用基本连接方法的 Oracle 数据库、PostgreSQLSQL Server,此为必填项。

身份验证方法

验证数据库连接的方法。 身份验证方法可以为 SQL ServerWindows

对于 SQL Server,此为必填项。

投影

存储 BigQuery 数据集的工程。

对于 BigQuery,此为必填项。

帐户名

保存数据库的帐户的名称。

对于 Snowflake,此为必填项。

域或用户名

用于对数据库连接进行身份验证的域名或用户名。 对于使用 Windows 身份验证的 SQL Server 连接,请使用域名。 对于所有其他数据库和身份验证方法,请使用用户名。

对于 OraclePostgreSQLSAP HANASnowflakeSQL Server,此为必填项。

密码

与您所使用的用户名对应的密码。

对于使用 SQL Server 身份验证的 OraclePostgreSQLSAP HANASnowflakeSQL Server 数据库,此为必填项。

服务帐户电子邮件

已连接到您的 Google 服务帐户的电子邮件地址。

对于 BigQuery,此为必填项。

私钥

您的 Google 服务帐户的私钥

对于 BigQuery,此为必填项。

使用 SSL 连接

启用使用安全套接字层 (SSL) 连接到 SAP HANA 数据库。

对于 SAP HANA,此为可选项。

数据库名称

您要连接的数据库的名称。

对于 SQL ServerPostgreSQLSnowflake,此为必填项。 对于 SAP HANA,此为可选项。

仓库名称

您要连接的仓库的名称。

对于 Snowflake,此为必填项。

方案名称数据集名称

数据库连接的默认方案 (Snowflake) 或数据集 (BigQuery)。 此方案或数据集用于存储在分析工作流期间为读写连接创建的临时表。 如果未选择任何方案或数据集,或者用户不具有方案或数据集的读写权限,则数据库连接将为只读。

对于 SnowflakeBigQuery,此为可选项。

索引列

Insights 将使用 OracleSQL ServerPostgreSQL 数据库为某些功能创建数据库表的索引,以提高性能。 对于 OracleSQL Server 数据库,只有在创建数据库连接的用户具有所需的数据库权限时才能进行索引。 创建连接后,将在 Insights 中的数据库表上创建索引,无论使用者是谁。

如果创建数据库连接的用户没有必要的权限,则不会为数据库表创建索引。

下表描述了为每种数据库类型执行索引的方法以及创建索引连接所需的权限:

数据库描述索引类型所需权限
SAP HANA

未在 SAP HANA 数据库的 Insights 中完成索引。

不适用

不适用

Oracle

将在以下情景中执行索引:

  • 在数据集上计算字段。
  • 使用数据集创建关系。
  • 在数据集上使用丰富数据。
  • 在数据集上启用位置(包括通过空间分析结果启用位置的情况)。
  • 数据被投影到不同的地理坐标系中。 如果数据集的坐标系与底图的坐标系不匹配,则将投影数据。

非唯一

使用数据缓存连接并浏览内容。

下列操作之一:

  • 身为表所有者的用户。
  • 表所有者向用户授予了 CREATE INDEX ON <table name> 权限。
SQL Server

将在以下情景中执行索引:

  • 将过滤器应用到数据集。
  • 使用数据集创建关系。
  • 在数据集上使用丰富数据。
  • 在数据集上启用位置(包括通过空间分析结果启用位置的情况)。

非唯一

使用数据缓存连接并浏览内容。

PostgreSQL

将在以下情景中执行索引:

  • 将过滤器应用到数据集。
  • 使用数据集创建关系。
  • 已创建时间序列图。

非唯一

使用数据缓存连接并浏览内容。

Snowflake

未在 Snowflake 数据库的 Insights 中完成索引。

不适用

不适用

BigQuery

未在 BigQuery 数据库的 Insights 中完成索引。

不适用

不适用

空间类型

默认空间类型用于确定当使用启用位置将位置字段添加到数据库数据集时将使用的空间类型。 下表描述了各数据库类型可用的默认空间类型:

数据库支持的默认空间类型
SAP HANA
  • ST_Geometry
Oracle
  • Oracle 空间
  • Esri 地理数据库
SQL Server
  • 几何
PostgreSQL
  • PostGIS 几何
  • Esri 地理数据库
Snowflake
  • 地理
BigQuery
  • 地理
注:

SDELOB 空间类型不受支持。

资源

有关 Oracle 中企业级地理数据库的创建和故障排除的更多信息,请参阅 Oracle 中的地理数据库

有关 Microsoft SQL Server 中企业级地理数据库的创建和故障排除的更多信息,请参阅 Microsoft SQL Server 中的地理数据库

有关 PostgreSQL 中企业级地理数据库的创建和故障排除的更多信息,请参阅 PostgreSQL 中的地理数据库

接下来的步骤

现在您已创建数据库连接,您可以将连接与您的组织共享将数据添加到工作簿。