// 無料のツール

Oracle接続文字列ビルダー

Oracle の Easy Connect 文字列、TNS 接続記述子、JDBC thin URL、ODP.NET 文字列を 1 つのフォームから作成するか、文字列を貼り付けて、ホスト、ポート、サービス名を確認し、SID とサービス名の取り違えを見つけられます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。

SQLly でこの接続を開く

SQLly の接続エディターを、入力済みの状態で開きます。

設計段階からプライベート。 ビルダーとデコーダーは、このタブで動く素の JavaScript です。ページは、入力した内容を含むリクエストを一切送信せず、何も保存せず(ブラウザー内にも保存しません)、一度読み込めばオフラインでも動作し続けます。「SQLly で開く」リンクは、ブラウザーからお使いのコンピューター上のアプリへ直接つながります。

Oracle接続文字列フォーマット

Oracle クライアントがデータベースを指定する方法は 3 つあります: Easy Connect(host:1521/service_name)、完全な接続記述子((DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SERVICE_NAME=...))))、または次の中から解決される TNS エイリアス tnsnames.ora。JDBC thin、ODP.NET、python-oracledb、node-oracledb は、いずれも最初の 2 つを受け付けます。

よくある間違いは、SID とサービス名の取り違えです。プラガブルデータベースとクラウドデータベースには、サービス名で接続します。Easy Connect では SID をまったく表現できず、従来の JDBC 形式は host:port:SID サービス名を指定するとORA-12505で失敗します。

簡単接続 SQL*Plus、SQLcl、python-oracledb、node-oracledb、ODP.NET

db.example.com:1521/FREEPDB1

TLS 経由の Easy Connect 簡単接続プラス

tcps://db.example.com:2484/FREEPDB1

接続記述子 tnsnames.ora、すべての Oracle クライアント

(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=db.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=FREEPDB1)))

JDBC thin Oracle JDBC (ojdbc)

jdbc:oracle:thin:@//db.example.com:1521/FREEPDB1

ADO.NET(ODP.NET) Oracle.ManagedDataAccess

User Id=app_user;Password=your_password;Data Source=db.example.com:1521/FREEPDB1;

SQLAlchemy URL python-oracledb

oracle+oracledb://app_user:[email protected]:1521/?service_name=FREEPDB1

次のようなプレースホルダー your_password 例にすぎません。実際の文字列は上のフォームで組み立ててください。SQLlyをOracleに接続する方法の詳細: Oracle 向け SQLly.

Easy Connect (Plus) 構文

[[protocol:]//]host[,host2][:port][/service_name][:server_type][/instance_name][?parameter=value&...]。プロトコルは tcp (デフォルト)または tcps; どちらもポートの既定値は 1521 です。SID は Easy Connect では使えません。

キーワードシノニムデフォルト何ができるか
protocol - tcp tcps:// TLS を使用します。TLS リスナーは通常 Oracle の登録済みポートである 2484 を使いますが、明示的に指定する必要があります。
port - 1521 リスナーポート。
service_name - - データベースサービス。たとえば次のような PDB 名 FREEPDB1 または ORCLPDB1.
server_type - - dedicated, shared または pooled.
connect_timeout - なし 接続の確立にかける秒数。
transport_connect_timeout - - TCP 接続そのものにかける秒数。
retry_count / retry_delay - - / 0 接続の再試行と、その間隔。
ssl_server_dn_match - オン(19.2+ クライアント) ホストに対してサーバー証明書のDNを確認してください。
wallet_location - - TCPS 用のウォレットが入っているディレクトリ。

ODP.NET 接続文字列属性

ADO.NET スタイル。 Data Source Easy Connect 文字列、TNS エイリアス、または完全な記述子を指定できます。

キーワードシノニムデフォルト何ができるか
User Id - - データベースユーザー。
Password - - パスワード。特殊文字を含む場合は、二重引用符で囲んでください。
Data Source - - Easy Connect、エイリアス、または接続記述子。
DBA Privilege - - SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, SYSRAC.
Connection Timeout - 15 プールされた接続を待つ秒数。
Pooling - true 接続プール。
Max Pool Size - 100 最大のプール。
Min Pool Size - 1 最小のプール。
Incr Pool Size - 5 プールが拡大するときに追加される接続。
Statement Cache Size - 0 接続ごとにキャッシュされるステートメントの数。
Validate Connection - 偽 プールされた接続を払い出す前に検証します。
Connection Lifetime - 0 プールされた接続が存続できる秒数。

Oracle JDBC thin URL の形式

ユーザーとパスワードは、埋め込まずに接続プロパティとして渡します。

キーワードシノニムデフォルト何ができるか
jdbc:oracle:thin:@//host:port/service - - サービス名(Easy Connect)。
jdbc:oracle:thin:@tcps://host:port/service - - TLS。追加: ?wallet_location=/path ウォレット用。
jdbc:oracle:thin:@(DESCRIPTION=...) - - 完全な接続記述子。
jdbc:oracle:thin:@alias?TNS_ADMIN=/path - - そのディレクトリの tnsnames.ora にある TNS エイリアス (または oracle.net.tns_admin プロパティ)。
jdbc:oracle:thin:@host:port:SID - - レガシーな SID 形式です。サービス名の使用をお勧めします。

よくある Oracle の接続エラー

ORA-12154: TNS:could not resolve the connect identifier specified

理由: クライアントはこの文字列を TNS エイリアスとして扱いましたが、見つかりませんでした。次のものがありません: tnsnames.ora, TNS_ADMIN 別の場所を指している、またはエイリアスや Easy Connect 文字列のタイプミス。

修正: Easy Connect を使用する(host:1521/service)、または tnsnames.ora を介さない完全な接続記述子、あるいは次を設定します TNS_ADMIN ファイルを保持しているディレクトリへ。

ORA-12514: TNS:listener does not currently know of service requested in connect descriptor

理由: リスナーには到達できますが、そのサービス名を登録しているデータベースはありません。原因は、サービス名の間違いやスペルミス、サービス名として指定された SID、またはデータベースが開いていないことです。

修正: 実行 lsnrctl services (または DBA に問い合わせて)登録済みのサービスを確認し、その名前のいずれかを使用してください。

ORA-12505: TNS:listener does not currently know of SID given in connect descriptor

理由: 接続文字列は SID による接続です(host:port:SID または (SID=...))で、値がリスナーの認識している SID ではない場合です。実際にはサービス名であることが多いためです。

修正: サービス名の形式に切り替えます: //host:port/service_name.

ORA-12541: TNS:no listener

理由: そのホストとポートで待ち受けているものはありません: リスナーが停止している、ポートが間違っている、またはファイアウォールがブロックしています。

修正: 確認 lsnrctl status サーバー、ポート (デフォルトは 1521)、ファイアウォールで。

ORA-01017: invalid username/password; logon denied

理由: ユーザー名またはパスワードが違います。パスワードは大文字小文字が区別され、特殊文字を含むパスワードはSQL*Plusでは二重引用符が必要な場合があります。

修正: 認証情報を確認し、SQL*Plus ではパスワードを次のように引用符で囲みます user/"p@ss"@host/service.

ORA-28000: the account is locked

理由: ログインの失敗が多すぎるか、DBA がアカウントをロックしました。

修正: DBA が次を実行する ALTER USER app_user ACCOUNT UNLOCK;.

Oracle接続文字列FAQ

Oracle Easy Connect 文字列とは何ですか?

簡易接続識別子、 host[:port]/service_name、これには tnsnames.ora のエントリは不要です。Easy Connect Plus(19c 以降)では次が追加されます tcps://、複数のホストと ?parameter=value 次のようなオプション connect_timeout.

SID とサービス名の違いは何ですか?

SID は 1 つのデータベースインスタンスを指す名前です。サービス名は、クライアントがリスナーに要求する名前で、1 つのデータベース(またはプラガブルデータベース)が複数提供できます。最近のデータベースやクラウドのデータベースには、サービス名で接続します。Easy Connect が受け付けるのはサービス名のみです。

Oracle のデフォルトポートは何ですか?

1521 はリスナー用です。TLS(TCPS)も、別のポートを設定しない限り同じ既定値を使います。多くのサイトでは、Oracle over TLS 用に登録されたポートである 2484 を使います。

Oracle Client をインストールせずに python-oracledb で接続するにはどうすればよいですか?

python-oracledb は既定で Thin モードで動作し、Oracle Client ライブラリを必要としません: oracledb.connect(user=..., password=..., dsn="host:1521/service").

SQLly は接続文字列から Oracle 接続を開けますか?

SQLly は Oracle に接続できますが、貼り付けた接続文字列を読み取る機能はまだ Oracle の文字列に対応していないため、Oracle では「SQLly で開く」ボタンは無効になっています。代わりに、SQLly の接続エディターでホスト、ポート、サービス名を入力してください。

// 接続文字列はまるごと不要

つなぐのは一度だけ。あとは SQL を書くだけ。

SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。接続文字列を接続エディターに貼り付け、パスワードはシステムのキーチェーンに保管し、Oracle などでスキーマ対応の IntelliSense を利用できます。