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