リスナー、その IP、読み取り専用ルーティング構成を確認する

コマンド

-- Listener, port and IP states:
SELECT ag.name AS ag_name, l.dns_name, l.port, l.is_conformant,
       ip.ip_address, ip.ip_subnet_mask, ip.state_desc
FROM   sys.availability_group_listeners l
  JOIN sys.availability_groups ag ON ag.group_id = l.group_id
  LEFT JOIN sys.availability_group_listener_ip_addresses ip ON ip.listener_id = l.listener_id;

-- Read-only routing list: where read intent goes when X is primary:
SELECT ag.name AS ag_name, pr.replica_server_name AS when_primary_is,
       rl.routing_priority, sr.replica_server_name AS route_to,
       sr.read_only_routing_url, sr.secondary_role_allow_connections_desc
FROM   sys.availability_read_only_routing_lists rl
  JOIN sys.availability_replicas pr ON pr.replica_id = rl.replica_id
  JOIN sys.availability_replicas sr ON sr.replica_id = rl.read_only_replica_id
  JOIN sys.availability_groups ag   ON ag.group_id = pr.group_id
ORDER BY ag.name, when_primary_is, rl.routing_priority;

-- Replica endpoint and connection settings:
SELECT replica_server_name, endpoint_url, read_only_routing_url,
       secondary_role_allow_connections_desc, seeding_mode_desc, session_timeout
FROM   sys.availability_replicas;

-- Routing test from the command line (-d is required with -K ReadOnly):
-- sqlcmd -S tcp:AGL-Musteri,1433 -d Musteri -E -M -K ReadOnly -Q "SELECT @@SERVERNAME"

概要

リスナーの DNS 名、ポート、各サブネット IP のクラスタ状態を表示する。読み取り専用ルーティングリスト内の各プライマリシナリオについて、読み取りインテントの接続がどのレプリカと URL にルーティングされるかを表示する。

使用する場面

フェイルオーバー後にアプリケーションが接続できない場合、ApplicationIntent=ReadOnly の接続がプライマリに到達する場合、または新しいサブネット / レプリカを追加した場合。

注意

読み取り専用ルーティングは、ApplicationIntent=ReadOnly と明示的なデータベースを指定してリスナー経由で行った接続でのみ機能する。インスタンス名への直接接続はルーティングされない。read_only_routing_url が空のレプリカはルーティング先になれない。マルチサブネットリスナーでは、MultiSubnetFailover=True を指定しないクライアントはフェイルオーバー後に 20〜30 秒の接続タイムアウトが発生する。読み取り専用クエリのため安全。