\help コマンドは、パラメータの有無にかかわらず使用できます。 パラメータを指定せずに使用すると、使用可能な MySQL Shell コマンド、グローバルオブジェクトおよびメインヘルプカテゴリに関する情報を含む一般的なヘルプメッセージが出力されます。

このパラメータをパラメータとともに使用すると、MySQL Shell が現在実行されているモードに基づいて使用可能なヘルプを検索するために使用されます。 パラメータには、ワード、コマンド、API 関数または SQL ステートメントの一部を指定できます。 次のカテゴリが存在します:

API 関数など、トピックのヘルプを検索するには、関数名を pattern として使用します。 ワイルドカード文字 ? を使用して単一の文字を照合し、* を使用して検索で複数の文字を照合できます。 ワイルドカード文字は、パターン内で 1 回以上使用できます。 次のネームスペースは、ヘルプの検索時にも使用できます:

たとえば、トピックのヘルプを検索するには、\help pattern を発行し、次のようにします:

指定された検索パターンによっては、1 つまたは複数の結果が見つかります。 タイトルに検索パターンが含まれているヘルプトピックが 1 つだけの場合は、そのヘルプトピックが表示されます。 複数のトピックタイトルがパターンと一致するが、1 つが完全一致の場合、そのヘルプトピックが表示され、その後にパターン一致を含む他のトピックのリストがタイトルに表示されます。 完全一致が識別されない場合は、タイトルにパターン一致があるトピックのリストが表示されます。 トピックのリストが返された場合は、関連トピックのタイトルに一致する拡張検索パターンを指定してコマンドを再度入力することで、表示するトピックをリストから選択できます。

\connect コマンドは、MySQL Server への接続に使用されます。 セクション4.3「MySQL Shell 接続」を参照してください。

例:

\connect root@localhost:3306

パスワードが必要な場合は、パスワードの入力を求められます。

--mysqlx (--mx) オプションを使用して、X プロトコル を使用して MySQL サーバーインスタンスに接続するセッションを作成します。 例:

\connect --mysqlx root@localhost:33060

--mysql (--mc) オプションを使用して ClassicSession を作成すると、クラシック MySQL プロトコル を使用してサーバーで SQL を直接発行できます。 例:

\connect --mysql root@localhost:3306

短い形式のオプション (-mx および -mc) を使用した単一ダッシュの使用は、MySQL Shell のバージョン 8.0.13 から非推奨になりました。

\reconnect コマンドは、パラメータまたはオプションなしで指定されます。 サーバーへの接続が失われた場合は、\reconnect コマンドを使用できます。これにより、MySQL Shell は既存の接続パラメータを使用してセッションの再接続を複数回試行します。 これらの試行が失敗した場合は、\connect コマンドを使用して接続パラメータを指定することで、新しい接続を作成できます。

MySQL Shell 8.0.22 から使用可能な\disconnect コマンドも、パラメータまたはオプションなしで指定されます。 このコマンドは、現在接続している MySQL サーバーインスタンスから MySQL Shell グローバルセッション (session グローバルオブジェクトで表されるセッション) を切断して、接続をクローズできるようにしますが、引き続き MySQL Shell を使用します。

サーバーへの接続が失われた場合は、\reconnect コマンドを使用できます。これにより、MySQL Shell は既存の接続パラメータを使用してセッションの再接続を複数回試行します。 これらの試行が失敗した場合は、\connect コマンドを使用して接続パラメータを指定することで、新しい接続を作成できます。

\status コマンドは、現在のグローバル接続に関する情報を表示します。 これには、接続されているサーバー、使用中の文字セット、稼働時間などに関する情報が含まれます。

\source コマンドまたはそのエイリアス\. を MySQL Shell 対話モードで使用して、特定のパスにあるスクリプトファイルからコードを実行できます。 例:

\source /tmp/mydata.sql

SQL、JavaScript または Python コードのいずれかを実行できます。 ファイル内のコードはアクティブな言語を使用して実行されるため、SQL コードを処理するには、MySQL Shell が SQL モードである必要があります。

MySQL Shell 8.0.19 からは、mysql クライアントとの互換性のために、SQL モードでのみ、バックスラッシュおよびオプションの SQL デリミタを指定せずに source コマンドを使用してスクリプトファイルからコードを実行できます。source またはエイリアス\. (SQL デリミタを使用しない) は、SQL の MySQL Shell インタラクティブモードでスクリプトを直接実行する場合と、バッチモードで処理された SQL コードのファイルでファイル内からさらにスクリプトを実行する場合の両方で使用できます。 SQL モードの MySQL Shell では、次の 3 つのコマンドのいずれかを使用して、対話モードまたはバッチモードから/tmp/mydata.sql ファイルのスクリプトを実行できるようになりました:

source /tmp/mydata.sql;
source /tmp/mydata.sql
\. /tmp/mydata.sql   

コマンド\source /tmp/mydata.sql も有効ですが、対話型モードでのみ有効です。

対話モードでは、\source、\. または source コマンド自体が MySQL Shell 履歴に追加されますが、実行されたスクリプトファイルの内容は履歴に追加されません。

\use コマンドを使用すると、アクティブなスキーマを選択できます。次に例を示します:

\use schema_name

\use コマンドでは、グローバル開発セッションがアクティブである必要があります。 \ use コマンドは、現在のスキーマを指定された schema_name に設定し、db 変数を選択されたスキーマを表すオブジェクトに更新します。

\history コマンドは、MySQL Shell で以前に発行したコマンドをリストします。 \history を発行すると、履歴エントリが発行された順序で履歴エントリが表示されます。履歴エントリ番号は、\history delete entry_number コマンドで使用できます。

\history コマンドには、次のオプションがあります:

デフォルトでは、履歴はセッション間で保存されないため、MySQL Shell を終了すると、現在のセッション中に発行した内容の履歴が失われます。 セッション間で履歴を保持する場合は、MySQL Shell history.autoSave オプションを有効にします。 詳細は、セクション5.5「コード履歴」を参照してください。

名前キャッシュのオートコンプリート機能を無効にした場合は、\rehash コマンドを使用してキャッシュを手動で更新します。 たとえば、\use schema コマンドを発行して新しいスキーマをロードした後、\rehash を発行してオートコンプリート名キャッシュを更新します。 このオートコンプリートがデータベースで使用されている名前を認識した後、テーブル名などのテキストをオートコンプリートできます。 セクション5.3「コード自動補完」を参照してください。

\option コマンドを使用すると、すべてのモードで MySQL Shellconfiguration オプションをクエリーして変更できます。 \option コマンドを使用して、設定されている構成オプションをリストし、その値が最後にどのように変更されたかを表示できます。 また、これを使用して、セッションに対して、または MySQL Shell 構成ファイルで永続的に、オプションを設定および設定解除することもできます。 手順および構成オプションのリストは、セクション10.4「MySQL Shell オプションの構成」 を参照してください。

外部ページャを使用して、オンラインヘルプや SQL クエリーの結果など、画面の長い出力を読み取るように MySQL Shell を構成できます。 セクション4.6「ページャの使用」を参照してください。

\show コマンドは、組込み MySQL Shell レポートまたは MySQL Shell に登録されているユーザー定義レポートのいずれかの名前付きレポートを実行します。 コマンドの標準オプションと、レポートでサポートされているオプションまたは追加の引数を指定できます。 \watch コマンドは、\show コマンドと同じ方法でレポートを実行しますが、Ctrl + C を使用してコマンドを取り消すまで定期的に結果をリフレッシュします。 その手順は、セクション7.1.5「MySQL Shell レポートの実行」を参照してください。

\edit (\e) コマンドは、デフォルトのシステムエディタで編集用のコマンドを開き、MySQL Shell で編集したコマンドを実行用に表示します。 このコマンドは、キーの組合せ Ctrl-X Ctrl-E を使用して呼び出すこともできます。 詳細は、セクション5.4「コードの編集」を参照してください。

\system (\!) コマンドは、コマンドの引数として指定したオペレーティングシステムコマンドを実行し、MySQL Shell のコマンドからの出力を表示します。コマンドを実行できなかった場合、MySQL Shell はエラーを返します。 コマンドからの出力は、オペレーティングシステムによって指定されたとおりに返され、出力を表示するように指定した MySQL ShellJSON ラッピング関数または外部ページャツールでは処理されません。