OracleDG数据源如何配置_OracleDataGuard数据源设置-SQL-PHP中文网

配置Oracle Data Guard数据源的关键在于通过TNSNAMES.ORA定义包含主备库地址的连接别名，并启用FAILOVER_MODE实现故障转移；客户端使用该别名连接，当主库故障时自动尝试连接备库，确保高可用性。

oracledg数据源如何配置_oracledataguard数据源设置

配置Oracle Data Guard数据源，核心在于让客户端连接串能够智能地识别主库和备库，并在主库发生故障时，自动或半自动地切换到备库进行连接。这通常不是配置Data Guard本身，而是配置应用程序或客户端如何与受Data Guard保护的数据库进行交互，以确保高可用性。在我看来，这比很多人想象的要简单，但要真正做到无缝切换，一些细节的考量就显得尤为重要。

解决方案

要配置Oracle Data Guard数据源，最常见且推荐的做法是利用Oracle Net Services（TNS）的特性，在客户端的

TNSNAMES.ORA

登录后复制

文件中定义一个包含主备库地址的连接别名，并启用故障转移模式。这样，当主库不可用时，客户端连接请求会自动尝试连接备库。

以下是一个典型的

TNSNAMES.ORA

登录后复制

配置示例：

# 定义一个用于Data Guard环境的连接别名
DG_SERVICE_HA =
  (DESCRIPTION =
    (ADDRESS_LIST =
      # 主库监听器地址
      (ADDRESS = (PROTOCOL = TCP)(HOST = primary_db_host)(PORT = 1521))
      # 备库监听器地址 (通常在备库处于Open Read Only模式时，也可以接受连接)
      # 即使备库是Mount模式，客户端连接到其监听器也能接收到“服务不可用”的响应，
      # 并根据FAILOVER_MODE尝试下一个地址
      (ADDRESS = (PROTOCOL = TCP)(HOST = standby_db_host)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = your_service_name) # 确保主备库都注册了这个服务名
      (FAILOVER_MODE =
        (TYPE = SELECT) # 允许在SELECT语句执行过程中进行故障转移
        (METHOD = BASIC) # 基本故障转移方法
        (RETRIES = 20)   # 尝试连接的次数
        (DELAY = 3)      # 每次尝试之间的延迟秒数
      )
    )
  )

登录后复制

关键点解析：

ADDRESS_LIST
登录后复制
: 包含主库和备库的监听器地址。客户端会按照列表顺序尝试连接。
SERVICE_NAME
登录后复制
: 确保主库和备库都注册了相同的服务名。这是连接到数据库实例的关键标识。在Data Guard环境中，服务名通常在主备库角色切换后，会自动注册到新的主库上。
FAILOVER_MODE
登录后复制
: 这是实现自动故障转移的核心配置。
- ```
TYPE = SELECT
```
  登录后复制
  : 客户端会在执行SELECT语句时尝试故障转移。也可以是
```
SESSION
```
  登录后复制
  ，表示在会话建立时尝试。
- ```
METHOD = BASIC
```
  登录后复制
  : 基本的故障转移方法。
- ```
RETRIES
```
  登录后复制
  和
```
DELAY
```
  登录后复制
  : 定义了客户端在放弃连接之前，重试连接的次数和每次重试之间的延迟。这些参数对于处理短暂的网络波动或数据库重启非常有用。

在应用程序中，只需使用这个

DG_SERVICE_HA

登录后复制

别名作为数据库连接字符串的一部分即可。例如，对于Java JDBC，连接URL可能是

jdbc:oracle:thin:@DG_SERVICE_HA

登录后复制

。

为什么我的应用在Data Guard切换后无法自动重连？

这确实是一个非常普遍的问题，我遇到过不少开发者对此感到困惑。很多时候，大家配置了Data Guard，也做了角色切换，但应用就是“傻”在那里，非得手动重启才能恢复。这背后通常有几个原因，最核心的还是客户端连接配置和应用连接池行为。

首先，TNS配置不够完善是主因。如果你的

TNSNAMES.ORA

登录后复制

文件没有像上面那样明确设置

FAILOVER_MODE

登录后复制

，或者

RETRIES

登录后复制

和

DELAY

登录后复制

参数设置得太小，那么客户端在检测到第一次连接失败后，可能很快就放弃了，而不是继续尝试连接备库（现在的新主库）。没有

FAILOVER_MODE

登录后复制

，客户端就不知道要去尝试

ADDRESS_LIST

登录后复制

中的下一个地址。

其次，应用程序连接池的行为至关重要。大部分企业级应用都会使用连接池来管理数据库连接。这些连接池通常有自己的连接验证机制和重连策略。如果连接池的配置不当，即使TNS层面配置了故障转移，连接池也可能持有大量“死掉”的连接，或者没有及时清理和重新建立连接。常见的连接池配置问题包括：

缺乏连接验证：连接池没有配置在每次从池中获取连接时进行验证（如执行一个简单的
```
SELECT 1 FROM DUAL
```
登录后复制
）。这会导致应用拿到一个已经失效的连接。
重试机制不足：连接池本身的重试逻辑可能不够健壮，或者与TNS的重试机制冲突。
未启用或配置不当的TAF/FAN：虽然TNS的
```
FAILOVER_MODE
```
登录后复制
提供了基本的故障转移，但Oracle还提供了更高级的透明应用故障转移（TAF）和快速应用通知（FAN）功能。TAF通常通过JDBC驱动或TNS配置实现，它能让客户端在连接中断后，自动重新建立会话并尝试恢复事务。FAN则主要用于RAC环境，但也可以与Data Guard结合，更快地通知客户端数据库状态变化。如果这些高级功能没有正确启用或配置，应用的重连速度和无缝性就会大打折扣。

最后，数据库服务注册也是一个不容忽视的环节。在Data Guard角色切换后，新的主库必须能够正确地将其服务（

your_service_name

登录后复制

）注册到其监听器上。如果服务注册出现问题，客户端即使尝试连接到正确的IP和端口，也无法找到对应的服务。检查

lsnrctl status

登录后复制

和

show parameter service_names

登录后复制

是排查这类问题的有效手段。

配置Data Guard数据源时，主备库的TNS条目应该如何设置？

在配置Data Guard数据源时，主备库的TNS条目并不是分开设置的，而是将它们统一整合到一个客户端TNS别名中。这个别名的核心思想是提供一个“入口”，这个入口知道所有可能的数据库服务点（即主库和备库的监听器地址），并能根据配置的故障转移策略进行尝试。

回到我们之前的

TNSNAMES.ORA

登录后复制

示例，

ADDRESS_LIST

登录后复制

部分就是答案：

怪兽AI数字人

数字人短视频创作，数字人直播，实时驱动数字人

查看详情

DG_SERVICE_HA =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = primary_db_host)(PORT = 1521)) # 主库监听器
      (ADDRESS = (PROTOCOL = TCP)(HOST = standby_db_host)(PORT = 1521)) # 备库监听器
      # 可以添加更多备库地址，如果有的话
    )
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = your_service_name)
      (FAILOVER_MODE =
        (TYPE = SELECT)
        (METHOD = BASIC)
        (RETRIES = 20)
        (DELAY = 3)
      )
    )
  )

登录后复制

这里有几点需要强调：

地址顺序：
```
ADDRESS_LIST
```
登录后复制
中的地址顺序决定了客户端首次尝试连接的优先级。通常，我们会把当前的主库地址放在前面。然而，由于
```
FAILOVER_MODE
```
登录后复制
的存在，即使首个地址不可用，客户端也会尝试列表中的下一个地址，直到连接成功或达到重试上限。所以，顺序虽然有影响，但并非绝对关键，重点在于所有可能的服务点都在列表中。
SERVICE_NAME
登录后复制
的统一性：无论主库还是备库，它们都应该注册同一个
```
SERVICE_NAME
```
登录后复制
。这是Data Guard环境下的最佳实践，因为它允许客户端在角色切换后，无需修改连接字符串就能连接到新的主库。这个服务名通常在数据库参数
```
SERVICE_NAMES
```
登录后复制
中定义，并且在Data Guard角色切换时，Oracle会自动处理服务在不同实例间的注册和注销。
监听器状态：确保主库和备库上的监听器都处于运行状态，并且能够正确地接收连接。备库即使处于
```
MOUNT
```
登录后复制
模式，其监听器也应该能够响应连接请求，并告知客户端该服务当前不可用，从而促使客户端尝试
```
ADDRESS_LIST
```
登录后复制
中的下一个地址。如果备库是
```
OPEN READ ONLY
```
登录后复制
模式，那么它甚至可以直接接受读连接。

这种单一TNS别名、多地址列表的设置，是实现Data Guard高可用连接的基础。它让客户端对后端数据库的角色变化保持“无知”，只关心哪个地址当前能提供服务。

除了TNS配置，还有哪些因素会影响Data Guard数据源的连接稳定性？

仅仅依赖

TNSNAMES.ORA

登录后复制

配置，虽然是基础，但不足以保证Data Guard数据源的连接稳定性。实际操作中，我发现还有很多其他因素，它们共同决定了应用在面对数据库故障时的韧性。

应用程序连接池配置：这是最常见也最容易被忽视的环节。一个配置不当的连接池，可以轻易地“抵消”TNS层面的所有努力。
- 连接验证（Connection Validation）：务必启用连接池的连接验证功能。例如，在获取连接时执行
```
SELECT 1 FROM DUAL
```
  登录后复制
  。这样可以确保应用拿到的连接是活的，而不是一个指向已失效主库的“僵尸”连接。
- 空闲连接超时（Idle Timeout）：设置合理的空闲连接超时时间。过长的超时可能导致连接池持有大量实际上已断开但未被检测到的连接。
- 最大/最小连接数：根据应用负载合理设置，避免连接数不足导致瓶颈，或连接数过多造成资源浪费。
- 重试策略：有些连接池有自己的重试逻辑，确保它与TNS的
```
RETRIES
```
  登录后复制
  /
```
DELAY
```
  登录后复制
  协同工作，而不是相互冲突。
JDBC驱动版本与特性：Oracle JDBC驱动在不同版本中，对Data Guard和RAC等高可用环境的支持程度是不同的。
- TAF (Transparent Application Failover)：这是JDBC驱动层面的一个功能，它允许客户端在连接中断后自动重新建立会话，并尝试恢复中断的事务。虽然TNS的
```
FAILOVER_MODE
```
  登录后复制
  提供了基本能力，但JDBC驱动对TAF的支持能提供更无缝的体验。
- FAN (Fast Application Notification)：虽然FAN主要与RAC配合使用，通过OCI驱动或UCP（Universal Connection Pool）实现，但它也可以在Data Guard环境中，通过事件通知机制，更快地让客户端感知到数据库角色切换。这意味着客户端可以更快地清理失效连接，并尝试连接新的主库。
数据库服务注册与监听器配置：
- local_listener
  登录后复制
  和
  remote_listener
  登录后复制
  参数：这些数据库参数控制着实例如何向本地和远程监听器注册其服务。在Data Guard环境中，正确配置它们至关重要，以确保在角色切换后，新的主库能及时将其服务注册到对应的监听器上。
- 监听器日志：定期检查监听器日志，确保没有错误信息，并且服务注册正常。
网络基础设施的稳定性：这听起来有点老生常谈，但却是最基础也最容易出问题的地方。
- 网络延迟和抖动：高延迟或不稳定的网络连接，可能导致客户端频繁地认为数据库不可用，从而触发不必要的故障转移尝试。
- 防火墙和安全组：确保主备库之间以及客户端到主备库之间的所有必要端口（通常是1521）都是开放的，并且没有不必要的连接超时设置。
应用代码的健壮性：
- 异常处理：即使配置再完善，极端情况下连接中断也是可能发生的。应用代码应该能够捕获数据库连接相关的异常（如
```
ORA-03113
```
  登录后复制
  ，
```
ORA-03135
```
  登录后复制
  等），并实现恰当的重试逻辑或优雅降级。
- 幂等性：对于写入操作，确保其具有幂等性，这样在连接中断后重试时，不会造成数据重复或不一致。