从 ArcGIS 连接到 Oracle

要从 ArcGIS 客户端连接到 Oracle,在 ArcGIS 客户端计算机上安装 Oracle 客户端,设置引用 Oracle 客户端的环境变量,并从 ArcGIS 创建数据库连接。

如需发布引用 ArcGIS Server 数据库中数据的 Oracle web 服务,请将数据库连接文件注册到您的 ArcGIS Server 站点。

安装 Oracle 客户端软件

Oracle 客户端软件必须安装到将连接至数据库的所有 ArcGIS 客户端计算机上。 如果您没有在运行 ArcGIS 客户端的计算机上安装软件的权限,则需要请求 IT 部门为您安装并配置 Oracle 客户端。

请安装与要连接到的数据库版本兼容的 Oracle 客户端应用程序版本。

您可以按照 Oracle 文档中的说明,从 Oracle 处获取 Oracle Instant、Runtime 或 Administrator 客户端并安装在客户端计算机上。

可以使用下表中的信息来确定适用的 Oracle 客户端配置:

安装组合要使用的配置

ArcGIS Server(单机站点)和 Oracle 安装在一台服务器上;ArcGIS Pro 安装在其他计算机上。

在所有 Oracle 计算机上安装 64 位 ArcGIS Pro 客户端,并将 PATH 变量设置为 Oracle 客户端主目录。

无需在服务器上安装 Oracle 客户端,因为要连接的文件已随 Oracle 数据库管理系统一并安装。 确保 LD_LIBRARY_PATH (Linux) 或 PATH (Microsoft Windows) 系统变量已设置为 Oracle 主目录。

如果为 Oracle 客户端设置了一个 tnsname,那么在 ArcGIS Server 计算机和 ArcGIS Pro 计算机上也必须使用相同的名称。

ArcGIS Server 安装在独立于 DBMS 的一台或多台计算机上。 ArcGIS Pro 安装在与 OracleArcGIS Server 分开的计算机上。

在所有 Oracle 计算机上安装 64 位 ArcGIS Pro 客户端,并将 PATH 变量设置为 Oracle 客户端主目录。

在所有 Oracle 计算机上安装 64 位 ArcGIS Server 客户端,并确保将 PATH (Windows) 或 LD_LIBRARY_PATH (Linux) 系统变量设置为 Oracle 客户端主目录。

如果为 Oracle 客户端设置了一个 tnsname,那么在 ArcGIS Server 计算机和 ArcGIS Pro 计算机上也必须使用相同的名称。

ArcGIS ServerArcGIS Pro 安装在一台服务器上;Oracle 安装在另一台服务器上。

在所有 Oracle 计算机中安装 64 位 ArcGIS Server 客户端。 ArcGIS ServerArcGIS Pro 都将使用此客户端。

将 PATH 系统变量设置为 Oracle 客户端主目录。

ArcGIS ServerArcGIS ProOracle 全部安装在同一台计算机上。

ArcGIS ServerArcGIS Pro 将使用随 Oracle 数据库管理系统一同安装的 64 位客户端文件进行连接。

将 PATH 变量设置为 Oracle 客户端主目录。

如果您的 ArcGIS Server 站点中还包括其他服务器,请在站点中的每台服务器上安装 64 位 Oracle 客户端,并将 PATH 变量设置为 Oracle 客户端主目录。

ArcGIS Pro 进行连接

Oracle 计算机上安装 ArcGIS Pro 客户端后,将 PATH 环境变量设置为 Oracle 客户端的位置,然后创建数据库连接。

设置 PATH 变量

PATH 计算机上的 ArcGIS Pro 环境变量设置为 Oracle 客户端安装程序的位置。 有关设置 Microsoft Windows 环境变量的说明,请参阅 PATH 文档。

如果在设置 ArcGIS Pro 变量前已经在计算机上打开 PATH,则请重新启动它以选择新的设置。

连接到数据库

使用数据库连接对话框或创建数据库连接地理处理工具来添加数据库连接。

使用数据库连接对话框连接到 Oracle 的步骤如下所述。

  1. ArcGIS Pro 中打开目录窗格。
  2. 右键单击数据库,然后单击新建数据库连接
  3. 数据库平台下拉列表中选择 Oracle
  4. 连接类型下拉菜单中选择以下连接选项之一:
    • 基本 - 选择此选项可使用 Oracle Easy Connect 字符串进行连接。

      请确保 Oracle 实例已配置为允许使用 Easy Connect。 如果已安装完整的 Oracle 客户端,但想使用 Easy Connect 语法进行连接,请确保客户端上的 sqlnet.ora 文件已配置为允许使用 Easy Connect,且 Oracle 服务器已配置为允许 Easy Connect 语法。

    • TNS - 如果您已将 Oracle 客户端配置为在每台 ArcGIS 客户端计算机上使用 TNS 连接,请选择此选项。

      网络服务名称字段中,键入您已在 tnsnames.ora 文件中定义的网络服务名称。

      在以下示例中,网络服务名称在 tnsnames.ora 文件中定义为 myoratnsname:

      使用网络服务名称 myoratnsname 连接到 Oracle

  5. 如果您使用基本连接类型,请提供以下信息:
    1. 如果 Oracle 实例未侦听默认 Oracle 端口号,请在端口字段中键入非默认端口号。
    2. 主机名文本框中键入以下内容之一:

      • Oracle 服务器的名称,例如 myserver
      • Oracle 服务器的 IP 地址,例如 10:10:10:10。 对于 IPV6 地址,请将地址置于方括号中,例如,[4000:ab5:0:0:f666:d191:77f5:e2bd]
      • 包含 Oracle 服务器名称的 URL,例如 //myserver

    3. 数据库字段中输入 Oracle 服务名称或 ID。

    在以下示例中,Oracle 服务器名称为 myserver,Oracle 服务名称为 myoracledb,并且通过端口 60000 进行通信。

    请使用名为 myserver 的服务器和服务名称 myoracledb 的 Easy Connect 信息,通过非默认端口 60000 连接到 Oracle 数据库

  6. 选择连接到数据库时使用的身份验证类型:数据库身份验证操作系统身份验证
    • 如果选择操作系统身份验证,则不需要输入用户名和密码,系统会通过用于登录到操作系统的用户名和密码建立连接。 如果操作系统使用的登录信息不能用作数据库的登录信息,连接将失败。 如果正在使用 Oracle Instant Client,则不能使用操作系统身份验证。
      注:

      Oracle 中使用操作系统身份验证时,操作系统登录使用 os_authent_prefix 字符串(默认情况下为 OPS$)作为前缀,并存储在 USERNAME 表中。 连接到地理数据库时,用户名允许的最大字符数为 30。 在这些特殊情况下,ArcGIS 会将引号放置在用户名两侧以将其传递到数据库。 引号计入 30 个字符内。

    • 如果选择数据库身份验证,则必须分别在用户名密码文本框中提供有效的数据库用户名和密码。 用户名最多可以是 30 个字符。

      如果不希望将登录信息保存为连接的一部分,请取消选中保存用户名和密码;这样做有助于维护数据库的安全性。 但是,如果执行此操作,则系统会在每次连接时提示您提供用户名和密码。

    注:

    对于使用数据库身份验证且为 ArcGIS web 服务提供数据库访问的连接文件,或希望使用搜索 ArcGIS Pro 找到通过此连接文件访问的数据,都必须选中保存用户名和密码

  7. 连接文件名称字段中键入连接文件的名称。

    当提供连接信息后,系统将创建一个默认名称。 您可以使用默认值,或者键入更具描述性的文件名。

    这是将显示在目录窗格和视图中的名称,也是存储在磁盘上的 .sde 文件的名称。

  8. 单击验证以确认连接信息有效并且数据库可访问。

    如果数据库包含地理数据库并且连接有效,则地理数据库属性选项卡现在处于活动状态。 如有必要,您可以更改地理数据库连接属性以连接到传统版本,而非默认版本;将连接配置为分支版本连接或者连接到历史时刻

  9. 单击确定创建连接文件。

数据库连接将显示在目录窗格中的数据库下,同时将在 ArcGIS Pro 工程目录中创建连接文件 (.sde)。

ArcGIS Server 进行连接

Oracle 站点中的所有计算机上安装 64 位 ArcGIS Server 客户端后,设置变量,创建地理数据库连接文件,授予权限并将数据库注册到 ArcGIS Server 站点。

设置 PATH 环境变量(仅适用于 Windows

将每个 PATH ArcGIS Server 服务器上的 Windows 环境变量设置为 Oracle 客户端安装程序的位置。 有关设置 Microsoft Windows 环境变量的说明,请参阅 PATH 文档。

如果在配置 ArcGIS Server 客户端和设置 Oracle 变量前正在运行 PATH,则必须重新启动 ArcGIS Server。 您可以从 Windows 服务界面重新启动 ArcGIS Server

设置 LD_LIBRARY_PATH 环境变量(仅适用于 LinuxOracle Administrator、Developer 或 Runtime 客户端)

如果您已安装 Oracle Administrator、Developer 或 Runtime 客户端,将 LD_LIBRARY_PATH 系统变量设置为 Oracle 客户端主目录。

如果您已安装 Oracle Instant 客户端,则需要在 LD_LIBRARY_PATH 脚本中设置 init_user_param.sh 变量。

更改 init_user_param.sh 脚本(仅针对 Linux

在安装数据库客户端文件后,更改与 ArcGIS Server 一同安装的 init_user_param.sh 脚本以引用客户端文件。 可通过浏览至 <ArcGIS Server installation directory>/arcgis/server/usr 目录访问该脚本。

您必须更新 ArcGIS Server 站点中每台计算机上的 init_user_param.sh

注:

如果用户配置文件引用了 Oracle 客户端,并且用户配置文件和 init_user_param.sh 的客户端信息不同,则 ArcGIS Server 在尝试与数据库连接时可能会出现问题。 要解决连接问题,可从用户配置文件中移除参考信息,然后使用以下步骤再次引用数据库客户端库:

  1. 请确保 ArcGIS Server 每台计算机的安装程序所有者至少具有在数据库客户端库中读取和执行的权限。
  2. 在文本编辑器中打开 init_user_param.sh 脚本。
  3. 移除以 # 开头的行中的注释标记 (export)。

    如果安装了 Oracle Administrator、Developer 或 Runtime 客户端,请删除以 Oracle 开头的所有 export 行中的注释标记。

    #
    # For connection with Oracle Runtime or Administrator Client
    #
    export ORACLE_BASE=<Oracle_Installdir>/app
    export ORACLE_HOME=$ORACLE_BASE/<Oracle_release>/product/<Oracle_version>/<client_version>
    export ORACLE_SID=<set when applicable>
    export TNS_ADMIN=<set when applicable. e.g.$ORACLE_HOME/network/admin>
    export PATH=$ORACLE_HOME/bin:$PATH
    export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH

    如果使用 Oracle 数据库 Instant 客户端库,您只需取消注释并设置 $LD_LIBRARY_PATH,例如:

    #
    # For connection with Oracle Instant Client
    #
    export LD_LIBRARY_PATH=<Location_to_instantclient_11_2>:$LD_LIBRARY_PATH

  4. 设置导出变量的值。
    • 对于 Oracle Administrator、Developer 或 Runtime 客户端,取消注释并使用适合您个人安装情况的特定信息设置以下变量:
      • ORACLE_BASE=<Oracle_Installdir>

        <Oracle_Installdir> 是安装了 Oracle 客户端的顶级目录的路径和名称。

      • ORACLE_HOME=$ORACLE_BASE/<Oracle_Release>/product/<Oracle_Version>/client_1

        这是 Oracle 客户端库文件的路径。 将 ORACLE_HOME 设置为这些文件所在的目录。 默认情况下,目录名称为 client_1,但您的安装可能具有不同的目录名称。

      • 如果要使用 Oracle 系统 ID (SID) 进行连接,请将 ORACLE_SID= 设置为数据库的 Oracle 系统 ID。 如果要使用 Easy Connect 字符串进行连接,则注释掉此行。
      • TNS_ADMIN= 设置为 Oracle 客户端 TNS 管理文件的位置。 如果要使用 Easy Connect 字符串进行连接,则无需设置此值,但必须注释掉此行。
    • 对于 Oracle Instant Client,取消注释并仅设置 LD_LIBRARY_PATH 变量,将 <Location_to_instantclient> 替换为 Oracle Instant Client 文件所在的目录路径和名称。
    • 如果 ArcGIS ServerOracle 安装在同一台服务器上,则取消注释并设置以下变量:
      • ORACLE_BASE=<Oracle_Installdir>

        <Oracle_Installdir> 是安装了 Oracle 的顶级目录的路径和名称。

      • ORACLE_HOME=$ORACLE_BASE/<Oracle_Release>/product/<Oracle_Version>/client_1

        这是 Oracle 库文件的路径。 将 ORACLE_HOME 设置为这些文件所在的目录。 默认情况下,目录名称为 db_<n>,但您的安装可能具有不同的目录名称。

      • 如果要使用 Oracle 系统 ID (SID) 进行连接,请将 ORACLE_SID= 设置为数据库的 Oracle 系统 ID。 如果要使用 Easy Connect 字符串进行连接,则注释掉此行。
      • TNS_ADMIN= 设置为 Oracle 客户端 TNS 管理文件的位置。 如果要使用 Easy Connect 字符串进行连接,则无需设置此值,但必须注释掉此行。
  5. 保存并关闭脚本。
  6. 要使在 init_user_param.sh 文件中进行的更改生效,必须重新启动 ArcGIS Server

    为此,先后在 ArcGIS Server 站点的每台计算机上运行 stopserver.sh 脚本和 startserver.sh 脚本。

    ./stopserver.sh

    ./startserver.sh

创建数据库连接文件

使用 ArcGIS Pro 中的数据库连接对话框创建数据库连接文件,如上所述

或者,您可以在 ArcGIS Pro 中运行创建数据库连接工具或通过 ArcGIS Server 计算机使用 Python 运行创建数据库连接命令,以创建可连接到数据库的数据库连接文件 (.sde)。

以下信息专用于创建数据库连接文件,以用于 ArcGIS Server

  • 您必须将用户信息与连接文件一起保存。
  • 如果您选择使用操作系统身份验证,则使用域账户作为 ArcGIS Server 账户并将域账户添加到 Oracle 数据库。
  • 如果您使用 TNS 连接,请确保在 ArcGIS Server 站点中的所有计算机以及您发布的 ArcGIS Pro 客户端上的 tnsnames.ora 文件中使用相同的网络服务名称。

授予权限

必须在数据库中授予连接到数据库时所用的数据库用户、角色或 ArcGIS Server 账户(在使用操作系统身份验证的情况下)访问要发布的数据的权限。 具体权限以及需要授予这些权限的情况如下:

权限原因

CREATE SESSION

需要连接到数据库。

CREATE TABLE

选择集将导致在地理数据库中创建一个日志文件表。 如果用户没有此权限,则将在 sde 用户方案中创建日志文件表。

待发布数据集的 SELECT 权限

授予用户或 ArcGIS 账户至少拥有对待发布的数据集的 SELECT 权限

发布到可编辑要素服务的数据的 INSERT、UPDATE 或 DELETE 权限

要通过要素服务编辑数据,必须授予对数据库中数据集进行编辑所需的足够权限

数据库管理员必须授予上面列出的前两个权限。 如果数据位于地理数据库中,则数据所有者必须授予数据集所需的权限。 如果数据位于数据库中,则数据所有者可以从 ArcGIS 授予数据集权限,或者数据库管理员可以使用数据库工具授予所需的权限。

如果要为独立或联合 ArcGIS Server 站点将地理数据库注册为托管数据库,则连接的账户必须具有在地理数据库中创建数据的权限。

有关详细信息,请参阅 Oracle 地理数据库权限ArcGIS 中使用 Oracle 数据库的权限

注册数据库

要允许 ArcGIS Server 站点访问数据,使用您创建的数据库连接文件在 ArcGIS Pro添加注册的数据存储在门户中添加数据存储项目