Использование панели управления Cloudkit для управления хранилищем данных приложений Ios

На левой боковой панели перечислены все типы записей, определенные в вашей схеме. Нажатие любого типа записей отображает таблицу его записей, с столбцами для каждого поля. Вы можете сортировать, фильтровать и набирать пагины через большие наборы данных. Каждая запись имеет уникальный идентификатор записи (recordName), который остается постоянным во всех средах. В верхней части вкладки «Данные» вы найдете коммутатор зоны. Зоны являются логическими группировками записей; зона по умолчанию называется \ defaultZone, но вы можете создать пользовательские зоны для лучшей организации.

Управление типами записей

Типы записей определяют структуру ваших данных — аналогично таблице в реляционной базе данных. В панели инструментов вы можете создавать новые типы записей, добавлять или удалять поля, изменять типы полей (струна, число, дата, актив, ссылка и т. д.) и устанавливать значения по умолчанию. Панель инструментов предоставляет редактор на основе формы для этого, что гораздо более интуитивно понятно, чем написание JSON. Когда вы сохраняете тип записи в среде разработки, он сразу становится доступным для вашего приложения в этой среде. Имейте в виду, что типы записей в производстве не могут быть удалены или их поля удалены после создания; вы можете только добавлять новые поля. Это критическая мера безопасности для предотвращения потери данных.

Лучшая практика: Используйте среду разработки для экспериментов с типами записей перед их развертыванием. Редактор схемы панели инструментов включает в себя проверку, которая отображает несовместимые изменения (например, изменение поля от номера до актива). Всегда резервное копирование вашей схемы путем экспорта ее в виде файла JSON (доступного на вкладке «Настройки»), прежде чем вносить большие изменения.

Управление записями данных

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

Редактирование записей непосредственно в панели инструментов является мощным инструментом отладки. Например, если ваше приложение показывает неправильные данные из-за предыдущей ошибки, вы можете исправить запись вручную и проверить, что приложение принимает изменения. Однако будьте крайне осторожны: изменения, внесенные в панели инструментов, обходят любую бизнес-логику или проверку, которую вы имеете в своем приложении. Всегда дважды проверяйте, что данные, которые вы вводите, соответствуют вашим ожиданиям схемы и не нарушают никаких ограничений (например, требуемые поля или уникальные ключи).

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

Фильтрация и поиск записей

Панель приборов включает в себя конструктор фильтров, который позволяет указывать условия на любом индексированном поле. Например, вы можете фильтровать, чтобы показывать только записи, где булево поле находится или где поле даты находится в определенном диапазоне. Вы можете комбинировать несколько фильтров с логикой AND/OR. Это бесценно, когда вам нужно найти определенный фрагмент данных среди тысяч записей. Фильтры работают на стороне сервера, поэтому даже большие контейнеры быстро реагируют. Однако фильтрация на неиндексированных полях не поддерживается — вы должны убедиться, что поля, которые вы фильтруете, индексируются в вашей схеме (которая автоматически индексируется CloudKit для большинства типов полей, кроме Актива и Байтов).

Работа с зонами и безопасностью

Зоны CloudKit позволяют разделять данные вашего контейнера для более четкого контроля доступа и синхронизации. Панель приборов делает управление зоной простым. Вы можете создавать пользовательские зоны, переименовывать их и удалять их (удаление зоны удаляет все записи в пределах зоны). Каждая зона может иметь свой собственный набор разрешений, отдельный от разрешений уровня записи.

Безопасность является критическим фактором при управлении зонами. В CloudKit каждая запись может иметь конкретные разрешения (только для чтения в мире, только для создателя и т. Д.). Однако зоны позволяют устанавливать разрешения по умолчанию, которые применяются ко всем записям внутри них — если не переопределены. Для приложений, которым необходимо разделять публичные и частные данные, использование пользовательских зон является чистым архитектурным шаблоном. Например, у вас может быть «PublicZone» с читаемыми в мире записями и «PrivateZone», где может читать только создатель записи. Панель приборов позволяет редактировать эти настройки разрешений непосредственно в зоне.

Создание и удаление зон

Для создания зоны перейдите в раздел «Зоны» вкладки «Данные», нажмите «Добавить зону» и дайте ей имя. Идентификатор зоны должен быть строкой, которая уникальна в вашем контейнере. После создания вы можете перетаскивать типы записей в зону или назначать записи зонам во время создания. Удаление зоны вызовет диалог подтверждения, потому что все записи внутри постоянно удаляются. Используйте эту функцию осторожно — всегда экспортируйте записи из зоны до удаления.

Стратегии импорта и экспорта данных

Одной из наиболее ценных особенностей панели инструментов CloudKit является ее способность импортировать и экспортировать данные в формате JSON. Экспорт позволяет резервное копирование всего вашего контейнера (или выбранных типов записей / зон) в виде файла JSON. Импорт позволяет посеять новую базу данных или восстановить резервную копию. Обе операции необходимы для тестирования, постановки и аварийного восстановления.

Экспорт данных

Для экспорта перейдите на вкладку «Данные» и выберите типы или зоны записи, которые вы хотите включить. Нажмите кнопку «Экспорт». На панели управления будет подготовлен файл JSON, содержащий все записи и их текущие значения. Экспорт может быть большим — для контейнеров с десятками тысяч записей процесс может занять несколько минут. Вы можете экспортировать весь контейнер или подмножество с помощью фильтров. Обратите внимание, что экспортный файл включает определение схемы, если вы выберете опцию «Включить схему». Это полезно для воспроизведения той же структуры в другой среде.

Лучшая практика: Планируйте регулярный экспорт для вашего производственного контейнера. В то время как CloudKit является высоконадежным, наличие автономной резервной копии дает вам спокойствие и позволяет восстановить в определенный момент времени, если обнаружена ошибка повреждения данных. Храните файлы JSON в безопасном месте с контролем версий.

Импорт данных

Навигация на вкладку «Данные», нажмите «Импорт» и выберите действительный файл JSON. Панель инструментов проверит файл против вашей текущей схемы и покажет вам предварительный просмотр записей, которые будут импортированы. Если есть конфликты — например, если запись с тем же именем записи уже существует — вы можете пропустить или перезаписать его. Вы также можете выбрать импорт только новых записей. Имейте в виду, что импорт не обновляет схему — он просто вставляет или обновляет записи. Если вам нужно создать новый тип записи в рамках импорта, вы должны сначала добавить тип записи вручную через панель инструментов или через код приложения.

Производительность импорта варьируется. Для очень больших наборов данных (более 100 000 записей) рассмотрите возможность разделения файла на несколько меньших кусков и последовательного импорта, чтобы избежать тайм-аутов браузера. На панели приборов будет отображаться индикатор прогресса; не закрывайте вкладку браузера во время выполнения импорта.

Мониторинг и отладка с помощью панели инструментов

Помимо управления данными, панель инструментов CloudKit Dashboard предлагает инструменты мониторинга и отладки, которые могут помочь вам определить узкие места производительности, частоту ошибок и необычные шаблоны трафика.

Телеметрия и журналы

Вкладка Телеметрия предоставляет графики в реальном времени, показывающие количество запросов, задержку и частоту ошибок для ваших операций CloudKit. Вы можете фильтровать по типу операции (запрос, выбор, изменение и т. д.) и по временному диапазону. Это чрезвычайно полезно, когда вы подозреваете, что ваше приложение генерирует чрезмерные запросы или нажимает ограничения скорости. На панели управления также отображается поломка ошибок по коду ошибки, которая может направить вас к конкретным проблемам, таким как «сетевой сбой» или «зона не найдена».

На вкладке Logs показан хронологический список недавних запросов CloudKit, сделанных вашим приложением, включая идентификатор пользователя (если он аутентифицирован), операцию и любые ошибки. Вы можете проверить отдельные записи журнала, чтобы увидеть точные параметры запроса и ответ. Этот уровень прозрачности меняет правила игры для отладки — вы можете подтвердить, отправляет ли ваше приложение правильные запросы и получает ожидаемые результаты.

Управление подписками

Подписки CloudKit позволяют вашему приложению получать push-уведомления при изменении данных. Панель приборов позволяет создавать, просматривать и удалять подписки напрямую. Это может быть быстрее, чем тестирование через приложение, особенно когда вы хотите проверить, правильно ли сформирован орган уведомлений подписки. Вы также можете увидеть, сколько активных подписок зарегистрировано в каждом контейнере, помогая вам отслеживать утечки подписки.

Лучшие практики для использования панели инструментов CloudKit

Чтобы получить максимальную отдачу от панели управления CloudKit, избегая распространенных подводных камней, следуйте следующим рекомендациям:

• Всегда работайте в первую очередь в области развития. Вносите изменения в схемы и импортируйте тестовые данные в среду разработки, прежде чем продвигаться в производство. Как только схема находится в производстве, многие изменения становятся ограниченными.
• Регулярно восстанавливайте данные о производстве. Используйте функцию экспорта не реже одного раза в неделю или чаще, если ваше приложение обрабатывает данные с высокой оптовостью. Храните резервные копии в безопасном, версии местоположения.
• Используйте описательные имена типов записей и имена полей. Это облегчает навигацию по приборной панели для вас и вашей команды. Избегайте слишком длинных имен (более 255 символов не допускаются).
• Возьмите преимущество сборщика фильтров. При отладке используйте фильтры для изоляции записей, затронутых известным состоянием. Это может выявить закономерности, которые в противном случае могли бы остаться незамеченными.
• Следует внимательно проверять разрешения зоны. Панель приборов не предупреждает вас, если вы предоставляете чрезмерно разрешительный доступ к зоне. Всегда проверяйте, что чтение или запись в мире преднамеренно предназначены для данных в этой зоне.
• Мониторинг телеметрии во время нагрузочных тестов. При моделировании интенсивного использования держите вкладку Telemetry открытой, чтобы увидеть, попадает ли ваше приложение в пределы скорости запроса CloudKit (которые зависят от уровня вашего контейнера). Если вы видите всплески в коде ошибки «Limit Exceeded», вам может потребоваться оптимизировать ваши запросы или запросить более высокий предел.
• Используйте вкладку API Access для ключей сервер-сервер. Если в вашем приложении есть сопутствующий сервер, вы можете создать здесь токены API, чтобы позволить этому серверу получить доступ к CloudKit без учетных данных пользователя. Храните эти токены безопасно.

Заключение

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

Для дальнейшего чтения см. документацию панели инструментов Apple CloudKit и CloudKit Design Guide .