Сводка
Обновляет существующее соединение больших данных (BDC) и регистрирует все новые наборы данных, которые были добавлены в исходное местоположение.
Использование
Для этого инструмента требуется BDC. Чтобы создать BDC, воспользуйтесь инструментом Создать подключение больших данных.
Воспользуйтесь этими инструментами, чтобы добавить один или несколько новых наборов данных к существующему подключению больших данных. Кроме того, инструмент зарегистрирует наборы данных, удаленные инструментом Удалить набор данных из подключения больших данных. Ниже приведены потенциальные варианты применения этого инструмента:
- Вы скопировали папку с данными в имеющуюся папку исходного BDC и собираетесь отобразить ее в виде набора данных в BDC.
- Вы воспользовались инструментом Удалить набор данных из подключения больших данных и собираетесь снова добавить удаленные наборы данных BDC.
Этот инструмент не обновляет свойства существующего набора данных, отредактированные инструментом Обновить свойства набора данных подключения больших данных. Все изменения свойств будут сохранены. Для следующих сценариев есть рекомендуемые рабочие процессы:
- Вы изменили схему существующего исходного набора данных - примените инструмент Обновить свойства набора данных подключения больших данных для изменения полей. Можно, кроме того, воспользоваться инструментом Удалить набор данных из подключения больших данных для удаления набора данных и инструментом Обновить подключение больших данных, если в наборе данных BDC нет существующих изменений, которые вы хотите сохранить.
- Вы добавили новые файлы в имеющийся набор данных - дополнительных действий выполнять не требуется. При запуске вами инструмента геообработки анализа данных BDC все файлы набора BDC будут включены в анализ.
- Вы удалили имеющийся набор данных - воспользуйтесь инструментом Удалить набор данных из подключения больших данных для удаления набора данных из BDC
Сообщения инструмента будут содержать следующую информацию об обнаруженных наборах данных и их статусе:
- Пропущено - все существующие наборы данных пропускаются во время обновления и остаются как есть.
- Успешно - новые наборы данных, которые были обнаружены и добавлены в BDC.
- Сбой - наборы данных, которые не удалось добавить в BDC.
При поиске наборов данных в BDC может возникнуть две проблемы:
- Ожидаемые наборы данных отсутствуют. В этом случае проверьте, что указан правильный путь, который задает папку-источник, содержащую подпапки, и что тип данных поддерживается.
- Не удается зарегистрировать один или несколько наборов данных. Если наборы данных не удается зарегистрировать, изучите следующее:
Проблема Решение Пример Формат наборов данных не отвечает требованиям.
Откройте файл, чтобы убедиться, что он выглядит как ожидается. Если структура данных неверна, обновите его и повторите попытку.
Файл .csv содержит несколько строк и описание данных, затем только пустые строки.
Схемы наборов данных в папке не совпадают.
Все файлы в папке набора данных должны иметь одинаковую схему. Откройте файлы и сравните схемы. Исправьте не совпадающие схемы и снова попробуйте зарегистрировать набор данных.
Один файл .csv содержит 10 полей, другой - только 8.
Типы файлов набора данных в папке не совпадают.
Все файлы в папке набора данных должны иметь одно расширение (тип файла). Проверьте типы файлов в источнике данных и удалите или переместите лишние.
Набор данных шейп-файла - это та же папка, что и файл Parquet.
Не распознается формат полей.
Это происходит редко, но может случиться, если ORC и Parquet используют необычный формат. Убедитесь, что вы используете допустимые форматы полей.
Используется файл Parquet с неизвестным форматом поля.
Подробнее о том, почему наборы данных не удастся добавить в файл BDC
После обновления вами BDC запустите инструмент Описать набор данных, чтобы убедиться в том, что обновленный набор данных вас устраивает.
Инструмент Обновить подключение больших данных находит новые наборы данных. Для изменения BDC могут использоваться и следующие инструменты:
- Скопировать набор данных из Подключения больших данных – копирует набор данных из BDC в класс пространственных объектов.
- Дублировать набор данных из Подключения больших данных – создает вид существующего набора данных BDC.
- Удалить набор данных из Подключения больших данных – удаляет набор данных из BDC.
- Обновить параметры Набора данных подключения больших данных – изменяет свойства отдельных наборов данных BDC.
- Просмотреть набор данных из Подключения больших данных – предварительный просмотр первых десяти объектов в вашем наборе данных, чтобы убедиться, что они правильно зарегистрированы.
- Описать набор данных - чтобы убедиться в том, что обновленный набор данных вас устраивает.
Этот инструмент геообработки работает от Spark. Чтобы изучить вопросы, посвященные подключениям больших данных и работе с ними, см. раздел Подключения больших данных.
Синтаксис
arcpy.gapro.RefreshBDC(bdc_file, {visible_geometry}, {visible_time})
Parameter | Объяснение | Тип данных |
bdc_file | Обновляемый файл BDC. | File |
visible_geometry (Дополнительный) | Определяет, будут ли поля, используемые для идентификации геометрии, включены (видимы) в качестве полей для анализа при использовании файла BDC в других инструментах геообработки. Если поля геометрии невидимы, геометрия все равно будет применяться к набору. Настройку видимости геометрии можно изменить в BDC.
| Boolean |
visible_time (Дополнительный) | Определяет, будут ли поля, используемые для задания времени, включены (видимы) в качестве полей для анализа при использовании файла BDC в других инструментах геообработки. Если поля времени невидимы, время все равно будет применяться к набору. Настройку видимости времени можно изменить в BDC.
| Boolean |
Производные выходные данные
Name | Объяснение | Тип данных |
updated_bdc | Входной файл .bdc с обновленными наборами. | Файл |
Пример кода
Скрипт Python, демонстрирующий выполнение функции RefreshBDC.
# Name: RefreshBDC.py
# Description: Refreshes a big data connection to automatically discover datasets that
# have been added.
#
# Requirements: ArcGIS Pro Advanced License
# Import system modules
import arcpy
# Set local variables
bdcFile = r"c:\Projects\MyProjectFolder\my_BigDataConnection.bdc"
# Execute Refresh Big Data Connection
arcpy.gapro.refreshBDC(bdcFile)
Environments
Информация о лицензиях
- Basic: Нет
- Standard: Нет
- Advanced: Да