Oracle DB Tips

ORA-12224: TNS: リスナーがありません。 (TNS-12224)

01.ORA-12224 (TNS-12224)エラーとはどのようなエラーか？

クライアントからネットワークを介して Oracle Databaseにアクセスする際、クライアントは tnsnames.ora 内の接続記述子の ADDRESS 部で指定されたネットワークアドレスに接続を要求します。
要求したリスナーが起動されていないなどの理由で接続に失敗した場合、ORA-12224 エラーが発生します。

02.ORA-12224 エラーのエラー出力例

ORA-12224: TNS: リスナーがありません

※同様の状況で ORA-12541 (TNS-12541) として出力される場合もありますが、エラーの内容はいずれも同じです。

03.ORA-12224 の一般的な発生要因と対処

ORA-12224は一般に以下の要因で発生します。

リスナーが起動していない
tnsnames.ora と listener.ora 内のアドレスが一致していない

リスナーが起動していない

lsnrctl ユーティリティを使用してリスナーが正常に起動しているか確認します。

lsnrctl status [リスナー名]

起動されていない場合は、以下コマンドで起動します。

lsnrctl start [リスナー名]

tnsnames.ora と listener.ora 内のアドレスが一致していない

tnsnames.ora と listener.ora ファイルの ADDRESS セクション内のパラメータが一致しているか確認し、一致していない場合には修正します。
例えばリスナーが正常に起動している場合でも、以下のように tnsnames.ora とlistener.ora の ADDRESS 部の情報に不一致がある場合にはORA-12224エラーが発生します。

エラーが発生する例

ADDRESS 部で指定したポート番号(PORT= の値)が一致していないため、orcl というサービス名を使用して接続を行おうとすると本エラーが発生します。

+---- listener.ora 内のリスナー定義 ----------+
LISTENER =
(DESCRIPTION_LIST =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = host1)(PORT = 1521))
    )
  )
)

+---- tnsnames.ora 内のリスナー定義 ----------+
orcl =
(DESCRIPTION =
  (ADDRESS_LIST =
    (ADDRESS = (PROTOCOL = TCP)(HOST = host1)(PORT = 1522))
  )
  (CONNECT_DATA =
    (SERVICE_NAME = orcl)
  )
)

G:¥>sqlplus scott/tiger@orcl
SQL*Plus: Release 11.1.0.7.0 - Production on 金 1月 20 13:21:27 2012
Copyright (c) 1982, 2008, Oracle.  All rights reserved.
ERROR:
ORA-12541: TNS: リスナーがありません

04.キーワード

ORA-12224 TNS-12224 ORA-12541 TNS-12541 リスナーがありません

この記事の監修者

舛井智行 (ますいともゆき)

営業本部　企画&マーケティング部　次長

《資格》

Oracle Master Gold、Oracle RAC Expert、Linux Expert、LPIC Level1、Dbvisit Standby Certified Associate、基本情報技術者

《略歴》

2004年コーソル入社。2019年まで一貫してOracle Databaseの設計・構築・運用のサービス提供に従事。リモートDBAやリモート監視のサービス化、働き方改革プロジェクトで人事制度改革を手掛ける。2019年からライセンス販売強化のため企画&マーケティング部に異動。DbvisitやToad、DPAの取扱開始、販売促進活動を推し進め、ライセンス販売事業の売上拡大に注力中。

《主な著書》

オラクルマスター教科書 Gold DBA Oracle Database AdministrationⅡ
オラクルマスター教科書 Silver DBA Oracle Database Administration I
オラクルマスター教科書 Silver SQL Oracle Database SQL
Oracleの基本～データベース入門から設計/運用の初歩まで
プロとしてのOracle入門
Oracle Database 10g Oracle Enterprise Manager 逆引きクイックリファレンス

《担当者様からの一言》

コーソルはOracle Databaseの技術力において日本有数の知見を有すると自負しています。Oracle Masterの最高峰資格である『Oracle Master Platinum』の取得者数も日本No.1です。Oracle Databaseのことはもちろん、それ以外のDBについてもリモートDBAサービスを始めとした様々なサービス、製品を駆使してお客様のお困りごとを解消いたします。お困りごとがあればコーソルまでご相談ください。

峯岸隆一 (みねぎしりゅういち)

インフラソリューション部市ヶ谷クラウドサービスチームシニアエキスパート

《資格》

Oracle Master Gold、ORACLE MASTER Platinum、Oracle RAC Expert、
Oracle Database Cloud Service Oracle Infrastructure as a Service Cloud 2017 Implementation Essentials、
Oracle Cloud Infrastructure 2018 Architect Associate、
Oracle Cloud Infrastructure 2019 Architect Professional、
AWS Certified Solutions Architect – Associate、OSS-DB Silver、
MySQL 5.6 Database Administrator、基本情報技術者、テクニカルエンジニア(データベース)

《略歴》

2006年コーソル入社。2021年までOracle Databaseを中心にMySQLやGoldenGateなど、多岐にわたる製品のサポート業務に従事。2021年から企画&マーケティング部に異動し、Nutanix NDBサービス化、Qlik Replicateサービス化、AWS、OCIなど様々な製品のサービス化、クラウド環境上の製品検証、ブログ執筆を手掛ける。2023年からOCI技術に磨きをかけるべくOCI基盤の設計・構築業務を遂行中。

《主な著書》

オラクルマスター教科書 Gold DBA Oracle Database AdministrationⅡ
オラクルマスター教科書 Silver DBA Oracle Database Administration I
オラクルマスター教科書 Silver SQL Oracle Database SQL 　Oracleの基本～データベース入門から設計/運用の初歩まで

《担当者様からの一言》

コーソルはOracle Database製品および周辺製品において特化した技術力を有している会社です。また、育成にも力を入れており、新卒などOracle Databaseの知識がないエンジニアでも数年でOracle Master Platinumを取得するほどのエンジニアに育て上げることに成功しています。クラウド分野(AWS、Oracle Cloud)にも積極的に進出しておりますので、Oracle Databaseに関するサービスをご要望であればプラットフォーム問わず対応できるコーソルにご連絡下さい。