В режиме SQL автозаполнение с учетом контекста заполняет любое слово с соответствующими дополнениями. Можно автозаполнять:

Если вы подключаетесь к экземпляру MySQL, но не выбираете схему, автозаполнение доступно для глобальных объектов, наборов символов, двигателей, схем и так далее. Например, в стандартной установке MySQL, USE предлагает имена всех обнаруженных схем, если не указана одна или несколько релевантных букв имени схемы:

         SQL > use
         information_schema  mysql  performance_schema  sys

      

Если схема выбрана, дополнительная информация о схеме загружается и доступна для автозаполнения (таблицы, события и т. д.). Если вы переключаетесь со схемы на другую, объекты, загруженные из предыдущей схемы, остаются доступными для автозаполнения. Однако любой новый объект, добавленный во время сессии, не будет доступен для автозаполнения, пока не будет выполнена команда \rehash.

Чтобы получить список предложений или дополнить частичное слово из выбранной схемы, введите начальный фрагмент и дважды нажмите клавишу Tab. Например:

Если результатов много, вас попросят отобразить результаты или нет. Например:

Display all 118 possibilities? (y or n)
      

API автозаполнения SQL

API автозаполнения предоставляется разработчикам через следующие функции:

Они возвращают возможные кандидаты для автозаполнения.

Параметры:

Эта функция возвращает словарь, описывающий кандидатов для автозаполнения предложения, используя следующий синтаксис:

        {
         "context": {
           "prefix": string,
           "qualifier": list of strings,
           "references": list of dictionaries,
           "labels": list of strings,
         },
         "keywords": list of strings,
         "functions": list of strings,
         "candidates": list of strings,
        }
           

Например:

          JS > shell.autoCompleteSql("select * from  ",{serverVersion: "8.0.30", sqlMode: "STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION"})
            {
                "candidates": [
                    "schemas",
                    "tables",
                    "views"
                ],
                "context": {
                    "prefix": ""
                },
                "functions": [
                    "JSON_TABLE()"
                ],
                "keywords": [
                    "DUAL",
                    "LATERAL"
                ]
            }
      

В режимах JavaScript и Python строка для автозаполнения определяется справа налево, начиная с текущей позиции курсора при нажатии Tab. Содержимое внутри вызовов методов игнорируется, но должно быть синтаксически правильным. Это означает, что строки, комментарии и вложенные вызовы методов должны быть правильно закрыты и сбалансированы. Это позволяет правильно обрабатывать цепочки методов. Например, при вводе:

print(db.user.select().where("user in ('foo', 'bar')").e

Нажатие клавиши Tab приведет к попытке автозаполнения текста db.user.select().where().e, но этот некорректный код приводит к неопределенному поведению. Любые пробелы, включая символы новой строки, между токенами, разделёнными ., игнорируются.

По умолчанию механизм автозаполнения включен. В этом разделе объясняется, как отключить автозаполнение и как использовать команду MySQL Shell \rehash. Автозаполнение использует кэш имен баз данных, о которых MySQL Shell имеет информацию. При включенном автозаполнении этот кэш имен автоматически обновляется. Например, при загрузке схемы движок автозаполнения обновляет кэш имен на основе текстовых объектов, найденных в схеме, так что вы можете автоматически заполнять имена таблиц и т. д.

Для отключения этого поведения можно:

Когда кэш имен автозаполнения отключен, вы можете вручную обновить текстовые объекты, о которых автозаполнение имеет информацию, вызвав \rehash. Это принудительно перегружает кэш имен на основе текущей активной схемы.

Для отключения автозаполнения во время работы MySQL Shell используйте следующие ключи shell.options:

Оба ключа по умолчанию установлены в true и устанавливаются в false, если используется опция команды --no-name-cache. Для изменения кэширования имен автозаполнения для SQL во время работы MySQL Shell выполните:

shell.options['autocomplete.nameCache']=true

Используйте команду \rehash для ручного обновления кэша имен.

Для изменения кэширования имен автозаполнения для JavaScript и Python во время работы MySQL Shell выполните:

shell.options['devapi.dbObjectHandles']=true

Опять же, вы можете использовать команду \rehash для ручного обновления кэша имен.