← Cloudflare D1 / d1 / configuration

Расположение данных

Узнайте, как определяется место хранения данных в D1: где выполняется база данных и как оптимизировать её расположение под свои задачи.

По умолчанию D1 автоматически создает основной экземпляр базы данных в локации, ближайшей к месту отправки запроса на её создание. В большинстве случаев это позволяет D1 самостоятельно выбрать оптимальное расположение для вашей базы данных.

Юрисдикции позволяют создавать базы данных D1, которые выполняются и хранят данные строго в пределах региона, что помогает соблюдать требования к локализации данных, такие как GDPR ↗ или FedRAMP ↗.

Workers по-прежнему могут обращаться к базе данных, привязанной к юрисдикции, из любой точки мира. Ограничение по юрисдикции определяет только то, где выполняется и хранит данные сама база данных. Рассмотрите возможность использования Regional Services чтобы контролировать регионы, из которых Cloudflare отвечает на запросы.

1. На панели управления Cloudflare перейдите к разделу D1 SQL Database страницу.

   Перейдите в SQL-база данных D1 ↗

2. Выберите Create Database.

3. В разделе Расположение данных, выберите Укажите юрисдикцию и выберите юрисдикцию из списка.

4. Выберите Создание чтобы создать базу данных.

npx wrangler@latest d1 create db-with-jurisdiction --jurisdiction=eu

curl -X POST "https://api.cloudflare.com/client/v4/accounts/<account_id>/d1/database" \
     -H "Authorization: Bearer $TOKENn" \
     -H "Content-Type: application/json" \
     --data '{"name": "db-with-jurisdiction", "jurisdiction": "eu" }'

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

Явное указание location hint может пригодиться в случаях, когда большинство операций записи в конкретную базу данных выполняется не из того региона, где создается сама база данных. Location hint может быть полезен, когда:

• Работа в распределенной команде.
• Создание баз данных для конкретных пользователей в конкретных регионах.
• Используйте системы непрерывного развертывания (CD) или инфраструктуры как кода (IaC) для программного создания баз данных.

Указывайте подсказку расположения при создании базы данных D1, если:

• Использование wrangler d1 чтобы создать базу данных.
• Создание базы данных через панель управления Cloudflare ↗.

Чтобы указать подсказку расположения при создании новой базы данных, передайте --location флаг с корректной подсказкой расположения:

wrangler d1 create new-database --location=weur

Чтобы указать подсказку расположения при создании базы данных через панель управления:

1. На панели управления Cloudflare перейдите к разделу D1 SQL Database страницу.

   Перейдите в SQL-база данных D1 ↗

2. Выберите Create database.

3. Укажите имя базы данных и необязательную Расположение.

4. Выберите Создание чтобы создать базу данных.

D1 поддерживает следующие подсказки о расположении:

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

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

Если настроена юрисдикция, реплики для чтения создаются только в пределах юрисдикции, заданной при создании базы данных.

См. Репликация для чтения D1, где это описано подробнее.