← Cloudflare D1 / d1

Команды Wrangler

Команды Wrangler для D1 используют REST API для взаимодействия с control plane. На этой странице перечислены команды Wrangler для D1.

`d1 create`

Создает новую базу данных D1 и предоставляет привязку и UUID, которые нужно указать в файле конфигурации

Эта команда работает с удалёнными базами данных D1.

npx wrangler d1 create [NAME]

[NAME]string обязательно
Имя новой базы данных D1
--locationstring
Подсказка для основного расположения новой БД. Варианты: weur: Западная Европа eeur: Восточная Европа apac: Азиатско-Тихоокеанский регион oc: Океания wnam: Западная Северная Америка enam: Восточная Северная Америка
--jurisdictionstring
Расположение, к которому привязывается база данных D1 для выполнения запросов и хранения данных, чтобы соответствовать местным нормативным требованиям. Обратите внимание: если заданы jurisdictions, этот параметр расположения игнорируется. Варианты: eu: Европейский союз fedramp: дата-центры, соответствующие FedRAMP us: Соединенные Штаты
--use-remoteboolean
Используйте удалённую привязку при добавлении только что созданного ресурса в конфигурацию
--update-configboolean
Автоматически обновлять файл конфигурации, добавляя в него новый ресурс
--bindingstring
Имя привязки этого ресурса в вашем Worker

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 info`

Получить сведения о базе данных D1, включая её текущий размер и состояние

Эта команда работает с удалёнными базами данных D1.

npx wrangler d1 info [NAME]

[NAME]string обязательно
Имя БД
--jsonboolean по умолчанию: false
Возвращает вывод в формате JSON

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 list`

Получить список всех баз данных D1 в вашей учётной записи

Эта команда работает с удалёнными базами данных D1.

npx wrangler d1 list

--jsonboolean по умолчанию: false
Возвращает вывод в формате JSON

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 delete`

Удалить базу данных D1

Эта команда работает с удалёнными базами данных D1.

npx wrangler d1 delete [NAME]

[NAME]string обязательно
Имя или привязка БД
--skip-confirmationboolean псевдоним: --yпо умолчанию: false
Пропустить подтверждение

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 execute`

Выполнить команду или SQL-файл

Чтобы эта команда выполнилась успешно, необходимо указать либо --command, либо --file.

npx wrangler d1 execute [DATABASE]

[DATABASE]string обязательно
Имя или привязка БД
--commandstring
SQL-запрос, который нужно выполнить, или несколько запросов, разделенных ';'
--filestring
Файл .sql для загрузки
--yesboolean псевдоним: --y
Отвечайте «yes» на все запросы
--localboolean
Выполнить команды или файлы в локальной БД для использования с wrangler dev
--remoteboolean
Выполнить команды или файлы в удалённой базе данных D1 для использования с remote bindings или развёрнутым Worker
--persist-tostring
Укажите каталог для локального хранения данных (используется вместе с --local)
--jsonboolean по умолчанию: false
Возвращает вывод в формате JSON
--previewboolean по умолчанию: false
Выполнить команды или файлы в предварительной базе данных D1

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 export`

Экспортируйте содержимое или схему вашей базы данных в файл .sql

npx wrangler d1 export [NAME]

[NAME]string обязательно
Имя базы данных D1 для экспорта
--localboolean
Экспорт из локальной БД, которую вы используете с wrangler dev
--remoteboolean
Экспорт из удалённой базы данных D1
--skip-confirmationboolean псевдоним: --yпо умолчанию: false
Пропустить подтверждение
--outputstring обязательно
Путь к файлу SQL для вашего экспорта
--tablestring
Укажите, какие таблицы включить в экспорт
--no-schemaboolean
Выводить только содержимое таблицы, а не схему БД
--no-databoolean
Выводить только схему таблицы, а не содержимое самих баз данных

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 time-travel info`

Получить сведения о базе данных на определённый момент времени с помощью Time Travel

Эта команда работает с удалёнными базами данных D1.

Подробнее о Time Travel см. в https://developers.cloudflare.com/d1/reference/time-travel/

npx wrangler d1 time-travel info [DATABASE]

[DATABASE]string обязательно
Имя или привязка БД
--timestampstring
Принимает метку времени Unix (в секундах от начала эпохи) или RFC3339 (например, 2023-07-13T08:46:42.228Z) для получения закладки за
--jsonboolean по умолчанию: false
Возвращает вывод в формате JSON

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 time-travel restore`

Восстановить базу данных на определённый момент времени

Эта команда работает с удалёнными базами данных D1.

Подробнее о Time Travel см. в https://developers.cloudflare.com/d1/reference/time-travel/

npx wrangler d1 time-travel restore [DATABASE]

[DATABASE]string обязательно
Имя или привязка БД
--bookmarkstring
Закладка для использования с Time Travel
--timestampstring
Принимает метку времени Unix (в секундах от начала эпохи) или RFC3339 (например, 2023-07-13T08:46:42.228Z) для получения закладки за (в течение последних 30 дней)
--jsonboolean по умолчанию: false
Возвращает вывод в формате JSON

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 migrations create`

Создайте новую миграцию

Это создаст новый файл с версией внутри папки 'migrations'. Назовите файл миграции так, чтобы название описывало изменение. Так вам будет проще найти нужную миграцию в папке 'migrations'. Пример имени файла выглядит так:

0000_create_user_table.sql

Имя файла будет включать номер версии и указанное вами имя миграции.

npx wrangler d1 migrations create [DATABASE] [MESSAGE]

[DATABASE]string обязательно
Имя или привязка БД
[MESSAGE]string обязательно
Сообщение миграции

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 migrations list`

Просмотр списка неприменённых файлов миграций

npx wrangler d1 migrations list [DATABASE]

[DATABASE]string обязательно
Имя или привязка БД
--localboolean
Проверка миграций на локальной БД для использования с wrangler dev
--remoteboolean
Проверка миграций на удаленной БД для использования с wrangler dev --remote
--previewboolean по умолчанию: false
Проверка миграций на preview-базе данных D1
--persist-tostring
Укажите каталог для локального хранения данных (этот флаг нужно использовать вместе с --local)

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 migrations apply`

Применить все неприменённые миграции D1

Эта команда запросит подтверждение применяемых миграций. Подтвердите, что хотите продолжить. После применения будет создана резервная копия.

Ход выполнения каждой миграции будет выводиться в консоль.

При выполнении команды apply в среде CI/CD или другой неинтерактивной командной строке шаг подтверждения пропускается, но резервная копия все равно создается.

Если применение миграции приводит к ошибке, эта миграция откатывается, и остаётся применённой предыдущая успешная миграция.

npx wrangler d1 migrations apply [DATABASE]

[DATABASE]string обязательно
Имя или привязка БД
--localboolean
Выполнить команды или файлы в локальной БД для использования с wrangler dev
--remoteboolean
Выполнить команды или файлы в удалённой БД для использования с wrangler dev --remote
--previewboolean по умолчанию: false
Выполнить команды или файлы в предварительной БД D1
--persist-tostring
Укажите каталог для локального хранения данных (этот флаг нужно использовать вместе с --local)

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации

`d1 insights`

Экспериментально

Получить сведения о запросах, выполненных в базе данных D1

Эта команда работает с удалёнными базами данных D1.

npx wrangler d1 insights [NAME]

[NAME]string обязательно
Имя БД
--time-periodstring по умолчанию: 1d
Получите данные за период от текущего момента до указанного времени
--sort-typestring по умолчанию: sum
Выберите операцию, по которой нужно сортировать статистику
--sort-bystring по умолчанию: time
Выберите поле, по которому нужно сортировать статистику
--sort-directionstring по умолчанию: DESC
Выберите направление сортировки
--limitnumber по умолчанию: 5
получить информацию о первых X запросах
--jsonboolean по умолчанию: false
вернуть результат в формате JSON

Глобальные флаги

--vboolean псевдоним: --version
Показать номер версии
--cwdstring
Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstring псевдоним: --c
Путь к файлу конфигурации Wrangler
--envstring псевдоним: --e
Окружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestring
Путь к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionboolean псевдонимы: --x-provisionпо умолчанию: true
Экспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createboolean псевдоним: --x-auto-createпо умолчанию: true
Автоматически создавать черновые привязки к новым ресурсам
--install-skillsboolean по умолчанию: false
Перед выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestring
Используйте определённый профиль авторизации