创建数据库连接—ArcGIS Insights

注：

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

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

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

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

创建数据库连接

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

在主页中创建连接

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

单击连接选项卡。
单击新建连接，然后从菜单中选择数据库。
随即显示新建连接窗口。
选择您要连接的数据库类型。
仅列出可用于组织的数据库类型。有关详细信息，请参阅管理连接器类型。
的数据库提供连接属性。
必填字段将用星号 (*) 标记。
单击添加。
Insights 使用连接属性尝试连接数据库。成功后，连接将显示在连接页面。
如果 Insights 无法连接到数据库，则将显示错误消息。有关无法建立连接的原因的详细信息，请参阅数据库连接疑难解答。

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

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

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

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

通过以下方式之一打开添加到页面窗口：
- 创建工作簿。
  创建工作簿后，随即显示添加到页面窗口。
- 单击现有工作簿数据窗格上方的添加到页面按钮。
- 将在现有工作簿中创建页面。
  页面创建后，随即显示添加到页面窗口。
在添加到页面窗口中，选择数据库。
单击新建连接。
的数据库提供连接属性。
必填字段将用星号 (*) 标记。
单击确定。
Insights 使用连接属性尝试连接数据库。如果连接数据库可行，则将创建连接，并在中间窗格中列出数据库的数据集。可以从新连接选择数据集以添加到工作簿页面。

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

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

连接属性

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

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

注：

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


属性	描述	数据库
名称	将被分配给数据库连接的别名。名称属性不必与数据库名称相对应。	对于所有数据库，此为必填项。
类型	数据库类型，例如 Oracle 或 SQL Server。仅列出可用于组织的连接器。有关详细信息，请参阅管理连接器类型。	对于所有数据库，此为必填项。
默认空间类型	使用启用位置将位置字段添加到数据库数据集时所用的空间类型。	对于 Oracle 和 PostgreSQL，此为必填项。
连接方法	连接到 Oracle 数据库的方法。连接方法值可以是基本或 TNS。基本方法使用服务器名称、实例名称和端口号创建连接。 TNS 方法使用 TNS 文件路径和别名创建连接。	对于 Oracle，此为必填项。
服务器名称	数据库主机名。	对于使用基本连接方法的 Oracle 数据库、PostgreSQL、SAP 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，此为必填项。对于使用基本连接方法、PostgreSQL 和 SQL Server 的 Oracle 数据库来说，此为可选属性。
身份验证方法	验证数据库连接的方法。认证方法可以为 SQL Server 或 Windows。	对于 SQL Server，此为必填项。
工程	存储 BigQuery 数据集的工程。	对于 BigQuery，此为必填项。
账户名	保存数据库的账户的名称。	对于 Snowflake，此为必填项。
域或用户名	用于对数据库连接进行身份验证的域名或用户名。对于使用 Windows 身份验证的 SQL Server 连接，请使用域名。对于所有其他数据库和身份验证方法，请使用用户名。	对于 Oracle、PostgreSQL、SAP HANA、Snowflake 和 SQL Server，此为必填项。
密码	与您所使用的用户名对应的密码。	对于使用 SQL Server 身份验证的 Oracle、PostgreSQL、SAP HANA、Snowflake 和 SQL Server 数据库，此为必填项。
服务账户电子邮件	已连接到您的 Google 服务账户的电子邮件地址。	对于 BigQuery，此为必填项。
私钥	您的 Google 服务账户的私钥。	对于 BigQuery，此为必填项。
使用 SSL 连接	启用使用安全套接字层 (SSL) 连接到 SAP HANA 数据库。	对于 SAP HANA，此为可选项。
数据库名称	您要连接的数据库的名称。	对于 SQL Server、PostgreSQL 和 Snowflake，此为必填项。对于 SAP HANA，此为可选项。
仓库名称	您要连接的仓库的名称。	对于 Snowflake，此为必填项。
方案名称或数据集名称	数据库连接的默认方案 (Snowflake) 或数据集 (BigQuery)。此方案或数据集用于存储在分析工作流期间为读写连接创建的临时表。如果未提供任何方案或数据集，或者用户不具有方案或数据集的读写权限，则数据库连接将为只读。	对于 Snowflake 和 BigQuery，此为可选项。

索引列

Insights 将使用 Oracle、SQL Server 或 PostgreSQL 数据库为某些功能创建数据库表的索引，以提高性能。对于 Oracle 和 SQL 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 中的地理数据库。

接下来的步骤

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

有关此主题的反馈?

注：