MySQL Shell 8.0  /  MySQL Shell のカスタマイズ  /  起動スクリプトの操作

このページは機械翻訳したものです。

10.1 起動スクリプトの操作

MySQL Shell を JavaScript または Python モードで起動した場合、および JavaScript または Python モードに初めて切り替えた場合、MySQL Shell は実行する起動スクリプトを検索します。 起動スクリプトは、MySQL Shell が最初に対応する言語モードに入ったときに実行される指示を含む JavaScript または Python 固有のスクリプトです。 起動スクリプトを使用すると、次のいずれかの方法で JavaScript または Python コード実行環境をカスタマイズできます:

  • Python または JavaScript モジュールの検索パスを追加します。

  • グローバル関数または変数の定義。

  • JavaScript または Python を使用して、その他の可能な初期化を実行します。

関連する起動スクリプトは、JavaScript または Python モードで MySQL Shell を起動または再起動したとき、および MySQL Shell の実行中にこれらのモードを初めて他のモードに変更したときにロードされます。 この後、MySQL Shell は起動スクリプトを再度検索しないため、起動スクリプトへの更新を実装するには、関連するモードにすでに入っている場合は MySQL Shell を再起動する必要があります。 MySQL Shell を SQL モードで起動するか、そのモードに切り替えると、起動スクリプトはロードされません。

起動スクリプトはオプションであり、カスタマイズに使用する場合は作成できます。 起動スクリプトの名前は次のようにする必要があります:

  • JavaScript モードの場合: mysqlshrc.js

  • Python モードの場合: mysqlshrc.py

次に示す任意の場所に起動スクリプトを配置できます。MySQL Shell は、指定された順序で、ファイル名が mysqlshrc の起動スクリプトと、初期化されるスクリプトモードに一致するファイル拡張子 ( MySQL Shell が言語モードを指定せずに起動された場合、デフォルトで .js) を検索します。 MySQL Shell では、スクリプトモードで検出されたすべての適切な起動スクリプトが検出された順序で実行されることに注意してください。 2 つの異なる起動スクリプトで何かが定義されている場合は、後で実行されるスクリプトが優先されます。

  1. プラットフォーム標準グローバル構成パス内。

    • Windows の場合: %PROGRAMDATA%\MySQL\mysqlsh\mysqlshrc.[js|py]

    • Unix の場合: /etc/mysql/mysqlsh/mysqlshrc.[js|py]

  2. MySQL Shell ホームフォルダの share/mysqlsh サブディレクトリ (環境変数 MYSQLSH_HOME で定義するか、MySQL Shell で識別できます)。 MYSQLSH_HOME が定義されていない場合、MySQL Shell は、mysqlsh バイナリを含む bin という名前のフォルダの親フォルダとして独自のホームフォルダを識別します (そのようなフォルダが存在する場合)。 (多くの標準インストールでは、MYSQLSH_HOME を定義する必要はありません。)

    • Windows の場合: %MYSQLSH_HOME%\share\mysqlsh\mysqlshrc.[js|py]

    • Unix の場合: $MYSQLSH_HOME/share/mysqlsh/mysqlshrc.[js|py]

  3. mysqlsh バイナリを含むフォルダ内 (ただし、オプション 2 で説明されている MySQL Shell ホームフォルダが、予想される標準の場所で MySQL Shell によって指定も識別もされていない場合のみ)。

    • Windows の場合: <mysqlsh binary path>\mysqlshrc.[js|py]

    • Unix の場合: <mysqlsh binary path>/mysqlshrc.[js|py]

  4. MySQL Shell ユーザー構成パス。環境変数 MYSQLSH_USER_CONFIG_HOME で定義されます。

    • Windows の場合: %MYSQLSH_USER_CONFIG_HOME%\mysqlshrc.[js|py]

    • Unix の場合: $MYSQLSH_USER_CONFIG_HOME/mysqlshrc.[js|py]

  5. プラットフォームの標準ユーザー構成パス (オプション 4 で説明されている MySQL Shell ユーザー構成パスが指定されていない場合のみ)。

    • Windows の場合: %APPDATA%\MySQL\mysqlsh\mysqlshrc.[js|py]

    • Unix の場合: $HOME/.mysqlsh/mysqlshrc.[js|py]