データソースおよびドライバーダイアログ

Alt+Insert

データソースまたはドライバを作成します。

Delete

選択したアイテムをリストから削除します。

Ctrl+D

選択したデータソースまたはドライバのコピーを作成します。

Ctrl+B

選択したデータソースに関連付けられているドライバ設定に移動します。

選択したデータソースをグローバルまたはプロジェクトレベルに移動します。グローバルレベルとプロジェクトレベルの詳細については、データソースの管理を参照してください。

追加

Alt+Insert

データソースまたはドライバを作成します。

削除

Delete

選択したアイテムをリストから削除します。

複製

Ctrl+D

選択したデータソースまたはドライバのコピーを作成します。

ドライバーに移動

Ctrl+B

選択したデータソースに関連付けられているドライバ設定に移動します。

グローバル化またはプロジェクトへの移行

選択したデータソースをグローバルまたはプロジェクトレベルに移動します。グローバルレベルとプロジェクトレベルの詳細については、データソースの管理を参照してください。

ドライバーの変更

データソースをドライバに関連付けます。

変更をリセット

Ctrl+Alt+Z

選択した項目の変更を元に戻します。

ソースのロード

選択したカテゴリのスキーマに対するデータベースオブジェクトのソースコードをロードします。

ドライバーの使用箇所を表示

Alt+F7

選択したドライバを使用するデータソースを表示します。

最近使用したアイテムを切り替えます。

接続タイプ

データベース接続に使用する接続タイプ。

• URL のみこのオプションは、通常、データベース接続 URL を直接編集するためのオプションです。

  このオプションを選択すると、ユーザー、パスワード、URL のどのフィールドしか使用できません。

  URL をフィールドの中で正しく編集するべきです。ユーザー名とパスワードは、必要に応じて、対応するフィールド、または使用している JDBC ドライバーに適した形式の URL 内に指定されています。

• 他のオプション（DBMS 固有のオプション）を使用すると、AppCode は URL フィールドの上にあるフィールドの情報を使用して自動的にデータベース接続 URL を作成します。このような場合は、通常、URL を編集する必要はありません（必要に応じて変更できます）。

ドライバー

接続に使用するドライバーリストのドライバ。

ファイル

データベースファイルへのパス。

オープンアイコン（）を使用して、既存のデータベースファイルを選択します。

保存アイコン（）は、データベースファイルのコピーを作成し、そのコピー先へのパスを変更します。

パス

データベースファイルまたはフォルダーへのパス。

オープンアイコン（）を使用して、既存のデータベースファイルまたはフォルダーを選択します。

ホスト

データベースが配置されているコンピューターのホスト名（ドメイン名）または IP アドレス。データベースがローカルコンピューターにある場合は、localhost または 127.0.0.1 を指定します。

SSH を使用している場合は、SSH プロキシが実行されているコンピューターから、指定されたドメイン名または IP アドレスでデータベースホストにアクセスできる必要があります。SSH/SSL タブを参照してください。

ポート

データベースのポート番号。

データベース

ターゲットデータベースまたはスキーマの名前。

ユーザー

データベースユーザーアカウントの名前。

パスワード

データベースユーザーのパスワード。

保存

パスワードフィールドの設定を保存します。パスワードを保存するために次のオプションを選択できます。

• なし : データベースとの接続を確立するたびにパスワードが求められます。

• 再起動するまで: パスワードは現在の AppCode 実行に対してのみ保存されます。AppCode を終了して再度開く場合は、パスワードをもう一度入力する必要があります。

• セッションの間 : パスワードは、データベースとの現在の接続セッションの間だけ保存されます（データベースから切断するまで）。非アクティブにするアイコン（）または Ctrl+F2 を押すと、接続を終了できます。

• 永遠に: パスワードは AppCode ストレージに保存されます。次回 AppCode を開くときにパスワードを入力する必要はありません。

データベースの作成

データベースを作成するために URL に引数を追加します。このオプションは、一部のデータベース管理システム（Apache Derby (埋め込み) など）でのみ使用可能です。

URL

AppCode がデータベースに接続するために使用する URL。URL を指定するためのユーザーインターフェースは、接続タイプリストで選択されているオプションによって異なります。

接続のテスト

データベース接続設定が正しく、AppCode がデータベースと通信できることを確認します。通信情報をコピーするには、クリップボードにコピーアイコン をクリックします。

読み取り専用

読み取り専用ステータスを設定します。データソースを偶発的なデータ変更から保護するには、このチェックボックスをオンにします。

チェックボックスが選択されていると、データエディターのデータを変更することはできません。

ドライバーが読み取り専用ステータスをサポートしていない場合、クエリコンソールでデータの変更が可能になる場合があります。

トランザクション制御

データベーストランザクションの分離レベル(英語)と、トランザクションのコミット方法のモードを設定します。

• 自動 : データベースサーバーにローカルの変更を送信すると、現在のトランザクションが自動的にコミットされます。

• マニュアル : データベースサーバーに送信された変更は、コミットまたはロールバックできるトランザクションに蓄積されます。

スキーマの切り替え

AppCode がスキーマを切り替えるために使用するモードを定義します。

• 自動 : スキーマを自動または手動で切り替えます。このオプションを有効にすると、以前に構成された検索パス / 現在のスキーマが IDE の再起動の間に自動的に復元されます。

• マニュアル : 手動でのみスキーマを切り替えます。

• 無効: スキーマを切り替えません。

単一セッションモード

シングルセッションモードを有効にします。シングルセッションモードとは、データソースとすべてのコンソールが 1 つの同じセッションを使用することを意味します。このモードでは、データベースツリーで一時オブジェクトを表示したり、異なるコンソールで同じトランザクションを使用したりできます。コンソールの詳細については、クエリコンソールを参照してください。

N 秒ごとにキープアライブクエリを実行する

接続を維持するためにキープアライブクエリを実行します。サポートされていないデータベースのドライバ設定でカスタムクエリを定義できます。

N 秒後に自動切断

指定された秒数後にデータベースから切断します。

DBMSOUTPUT を有効にする

（Oracle、IBM Db2 LUW）新しいセッションに対してデフォルトで DBMS_OUTPUT を有効にします。

単一データベースモード

データベースツリービューで、接続設定で指定したデータベースのみを表示して有効にします。

データソースに接続すると、AppCode はデータソースが持つすべてのデータベースを取得して表示できます。ただし、場合によっては（たとえば、PgBouncer の特定の設定を使用して）、特定のデータベースでのみ操作できるか、許可されています。単一データベースモードが有効になっているデータベースツリービューには、接続設定で指定したデータベースのみが表示されます。

PostgreSQL、Azure SQL Database、Greenplum、Amazon、Redshift にはこの設定を使用することを検討してください。

スタートアップスクリプト

接続を確立するたびに SQL クエリを実行します。

メモ : 単一セッションモードチェックボックスがオフの場合、新しいクエリコンソールごとに新しい接続が作成されます。

自動同期

データベースの実際の状態を自動的に同期します。データベースの状態とは、データベースツールウィンドウに表示されるデータベースツリービューを意味します。

自動同期チェックボックスが選択されている場合、データソースのビューは自動的に更新されます。

• データソースおよびドライバーダイアログで OK をクリックしたとき。

• データソースに関連付けられたデータベースコンソールで DDL SQL ステートメントを実行するとき。

自動同期チェックボックスがオフの場合、データベースツールウィンドウのデータソースのビューは、リフレッシュボタン をクリックするか、Ctrl+F5 を押したときにのみ、データベースの実際の状態と同期されます。

ソースのロード

選択したスキーマのカテゴリのビュー、プロシージャ、パッケージ、その他のデータベースオブジェクトのソースコードを読み込みます: すべてのスキーマ（すべてのスキーマ）、システムスキーマを除くすべてのスキーマ（すべての除外対象システムスキーマ）、または機能を無効にします（なし）。

複数のデータソースのこの設定を同時に変更するには、対応するデータソースを選択します。選択を右クリックしてソースのロードに移動してオプションを選択します。

古い DDL の編集時に警告する

キャッシュされた DDL がデータベース内の実際の DDL と異なる場合は通知を表示します。

ソースコードを開くたびに、AppCode はインデックス作成プロセス中に読み込まれたバージョンを表示します。しかし、誰かが他のワークステーションからソースコードを変更すると、インデックス付きのバージョンは古くなります。

ご使用のバージョンがデータベース内のバージョンよりも古い場合は、次の通知が表示されます。Cached object differs from the object in the database

データベース / スキーマの作成と削除を追跡する

スキーマを作成、削除、名前変更すると、AppCode はイントロスペクションスコープウィンドウで使用可能なスキーマのリストを更新します。イントロスペクションスコープを表示するには、データベースツールウィンドウのデータソース名の近くにあるボタンをクリックします。

事前にイントロスペクションされたオブジェクトをイントロスペクションされていないシステムカタログに使用する

システムカタログの事前イントロスペクトオブジェクトの使用を切り替えます。イントロスペクションとシステムカタログの詳細については、システムカタログから事前にイントロスペクトされたオブジェクトを参照してください。

仮想オブジェクトと属性

仮想外部キーの関係を格納する external-data.xml へのパスを定義します。これらの関係は、自動補完リスト、データナビゲーション、ダイアグラムで使用されます。仮想オブジェクトと属性の詳細については、仮想外部キーの作成に関する手順を参照してください。

コードスタイル

スキーマに使用するコードスタイルを選択します。コードスタイルのカスタマイズの詳細については、SQL のコードスタイルを参照してください。

接続前

最初の接続の前（JDBC ドライバーが機能するプロセスの開始時）に AppCode が実行するタスクを選択します。タスクは順番に実行されます。

インクリメンタルのイントロスペクションを無効化

増分イントロスペクションを実行しないでください。このオプションは、Oracle、Microsoft、SQL Server、PostgreSQL などのデータベースで使用できます。

インクリメンタルイントロスペクションでは、イントロスペクターは、前回のイントロスペクション後にデータベースで変更されたオブジェクトを検出し、これらのオブジェクトのみをロードします。このオプションを有効にすると、イントロスペクターは常にすべてのオブジェクトをロードします。イントロスペクション時間が大幅に増える可能性があります。

LONG 値のフェッチ

Oracle カタログのビューに属する LONG 列から値をダウンロードする方法を選択します。このオプションは Oracle でのみ使用できます。

パフォーマンスが向上するため、デフォルトのオプションは XML です。Oracle XML テキストジェネレーターでエラーが発生した場合は、従来の方法の使用を検討してください。特にサーバーへの ping が長い場合、従来の方法ではイントロスペクション時間が長くなる可能性があることに注意してください。

サーバーオブジェクトのイントロスペクションを実行

サーバーオブジェクトのイントロスペクションを実行します。このオプションは Oracle でのみ使用できます。

pgdatabase へのクエリで xmin を使用しないでください

pg_database テーブルへのクエリで xmin 属性を使用しないでください。pg_database に xmin がない場合は、この回避策を使用してください。データベースが破損している可能性があることに注意してください。このオプションは PostgreSQL でのみ使用できます。

REGEXP 関数の登録

REGEXP 関数の実装を登録します。この実装は、デフォルトでは SQLite では使用できません。このオプションは SQLite でのみ使用できます。

ソースコードに SHOW CREATE を使用

SHOW CREATE ステートメントを使用して、オブジェクトソースコードの CREATE ステートメントを生成します。MySQL の information_schema では、トリガーとルーチンのソースコードが壊れています（bugs.mysql.com のバグ #66414(英語) を参照）。このオプションは MySQL でのみ使用できます。

セッション ID を自動的に割り当てる

接続ごとに一意の session_id を生成します。session_id を使用すると、さまざまなセッションステートメント（USE など）を使用できます。このオプションは、ClickHouse でのみ使用できます。

データベースとスキーマのリストをリフレッシュします。

すべてのツリーのすべてのノードを展開します。

すべてのツリーのすべてのノードを折りたたみます。

ツリー内のコンテンツをフィルタリングします。指定されたテキストを名前に含むデータベースとスキーマのみが表示されます。

スキーマパターン

パターンを定義して、必要なデータベースとスキーマを選択します。使用する構文に関する情報を取得するには、キャレットをフィールドに配置し、Ctrl+Q を押します。

• @ : 現在のデータベースまたはスキーマ

• * : すべてのデータベースまたはスキーマ *: の後にスキーマをリストすることができます。

次の例を考えてみましょう。

• *:* : すべてのデータベース内のすべてのスキーマ

• @:* : 現在のデータベースからのすべてのスキーマ

• @:@ : 現在のスキーマのみ

• *:dbo|@:@|db1:s1,s2,s3 : すべてのデータベースの dbo スキーマ、現在のスキーマ、db1 データベースのスキーマ s1,s2,s3

オブジェクトフィルター

各データソースのデータベースツールウィンドウに表示されるテーブルおよびその他のデータベースオブジェクトのセットを制限します。例: 解決範囲を table:actor.* に制限すると、actor テーブルのみがデータベースツールウィンドウ（表示 | ツールウィンドウ | データベース）でアクセス可能になります。

他のすべてのテーブルは範囲外になります。AppCode は、データベースツールウィンドウに表示されていないオブジェクトを解決しません。

オブジェクトフィルターフィールドの式を作成するときは、次のパターンを使用してください。

<type>:[-]<pattern>、ここ

<type> は、集計、照合、イベント、fdw、ftable、mview、演算子、パッケージ、ロール、ルーチン、シーケンス、シノニム、表、ユーザー、ビュー、vtable のいずれかです。

<pattern> は正規表現です。アイテムを除外するには、- （マイナス）を先頭に付けます。正規表現の詳細については、Java 2 プラットフォーム標準版 5.0 API 仕様のクラスパターン(英語)を参照してください。

内部システムスキーマの表示

内部システムスキーマ（たとえば、pg_toast または pg_temp）を表示または非表示にします。このオプションは PostgreSQL でのみ使用できます。

テンプレートデータベースの表示

テンプレートデータベース（たとえば、template1、template0）を表示または非表示にします。このオプションは PostgreSQL でのみ使用できます。

VM オプション

データベースドライバの JVM オプション。

特定の Oracle データベースバージョン（たとえば、Oracle バージョン 9）では、あなたのデータベースサーバーが異なるタイムゾーンにあるときに接続問題があるかもしれません。VM オプションフィールドでタイムゾーンのタイムオフセットを指定できます（たとえば、-Duser.timezone=UTC+03:00）。あるいは、「詳細設定」タブの表で、変数 oracle.jdbc.timezoneAsRegion を false に設定します。

VM 環境

データベースドライバ JVM の環境変数。

例: Oracle データベースのエンコーディング関連の問題は、NLS_LANG 変数を設定することで解決できます（NLS_LANG=Russian_CIS.CL8MSWIN1251 のように）。詳しくは、Oracle NLS_LANG FAQ(英語) を参照してください。

作業ディレクトリ

データソースの操作を処理するプロセスの作業ディレクトリ。また、すべての相対パスは、このディレクトリを基準にして解決されます（たとえば、ドライバープロパティのパス）。

例: SQLite のようなファイルベースのデータベースを作成し、SQLITE ファイルのパスを設定しない場合、ファイルはこの作業ディレクトリに作成されます。

クラス

使用するドライバクラスの完全修飾名。

JDBC ドライバー

AppCode は JDBC ドライバー(英語)を使用してデータベースと対話します。AppCode ドライバリポジトリからドライバをダウンロードして使用することも、コンピューターに保存するドライバを指定することもできます。

最新のドライバーバージョンをダウンロードして使用するには、「バージョンのダウンロード」をクリックします。N リンクです。

特定のバージョン番号のドライバを指定して使用することもできます。ver. <version_number> リンクをクリックして、使用するドライバのバージョンを選択してください。選択したバージョンが自動的にダウンロードされて適用されます。

コンピューターですでに利用可能なドライバーを使用できます。その場合は、追加ボタン をクリックして、ドライバーファイル（JAR 拡張子付き）を選択します。

URL テンプレート

データベース URL を構築するために使用されるテンプレート。巻き括弧のテキストは変数を表します。次の例を参照してください。

• {host} : データベースホストのドメイン名または IP アドレス。

• {port} : データベースのポート番号

• {database} : データベースまたはスキーマの名前。

オプションのフラグメントは角括弧で囲まれています (例: [:{port}])。

テンプレート名は、URL オプションリストのオプションの名前に対応しています。

トランザクション制御

データベーストランザクションの分離レベル(英語)と、トランザクションのコミット方法のモードを設定します。

• 自動現在のトランザクションは、ローカルの変更をデータベースサーバーに送信すると自動的にコミットされます。

• 手動データベースサーバーに送信された変更は、コミットまたはロールバックできるトランザクションに蓄積されます。

スキーマの切り替え

AppCode がスキーマを切り替えるために使用するモードを定義します。

• 自動 : スキーマを自動的または手動で切り替える。

• マニュアル : 手動でのみスキーマを切り替えます。

• 無効: スキーマを切り替えません。

スタートアップスクリプト

接続を確立するたびに実行される SQL クエリ。

メモ : 単一セッションモードチェックボックスがオフの場合、新しいクエリコンソールごとに新しい接続が作成されます。

Keep-alive クエリ

接続を維持するために実行されるキープアライブクエリ。

自動同期

自動同期オプションのデフォルト設定。

ソースのロード

選択したカテゴリのスキーマに対するデータベースオブジェクトのソースコードをロードします。

アプリケーション情報の送信

このチェックボックスをオンにすると、AppCode はデータベースサーバーに接続するときに、自分自身に関する情報を送信します。

ダイアレクト

対応するデータソースに関連付けられている SQL 言語。

コードスタイル

このドライバを使用するデータソースに使用するコードスタイルを選択します。コードスタイルのカスタマイズの詳細については、SQL のコードスタイルを参照してください。

同期後のソースを整形

同期後、データベースオブジェクトのソースコードにコードスタイルを適用します。

VM オプション

データベースドライバが実行される JVM のデフォルトオプション。ドライバは JVM 内の独立したプロセスとして起動されます。

VM 環境

データベースドライバ JVM の環境変数。

例: Oracle データベースのエンコーディング関連の問題は、NLS_LANG 変数を設定することで解決できます（NLS_LANG=Russian_CIS.CL8MSWIN1251 のように）。詳しくは、Oracle NLS_LANG FAQ(英語) を参照してください。