Обновить подключение больших данных (GeoAnalytics Desktop)

Краткая информация

Обновляет существующее соединение больших данных (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. Чтобы изучить вопросы, посвященные подключениям больших данных и работе с ними, см. раздел Подключения больших данных.

Параметры

Диалог

Подпись	Описание	Тип данных
Файл подключения больших данных	Обновляемый файл BDC.	File
Видимые поля геометрии (Дополнительный)	Определяет, будут ли поля, используемые для идентификации геометрии, включены (видимы) в качестве полей для анализа при использовании файла BDC в других инструментах геообработки. Если поля геометрии невидимы, геометрия все равно будет применяться к набору. Настройку видимости геометрии можно изменить в BDC. Отмечено - поля геометрии будут включены в качестве полей для анализа. Это значение по умолчанию Не отмечено - поля геометрии не будут включены в качестве полей для анализа.	Boolean
Видимые поля времени (Дополнительный)	Определяет, будут ли поля, используемые для задания времени, включены (видимы) в качестве полей для анализа при использовании файла BDC в других инструментах геообработки. Если поля времени невидимы, время все равно будет применяться к набору. Настройку видимости времени можно изменить в BDC. Отмечено - поля времени будут включены в качестве полей для анализа. Это значение по умолчанию Не отмечено - поля времени не будут включены в качестве полей для анализа.	Boolean

Производные выходные данные

Подпись	Описание	Тип данных
Обновленный набор больших данных	Входной файл .bdc с обновленными наборами данных.	File

Python

arcpy.gapro.RefreshBDC(bdc_file, {visible_geometry}, {visible_time})

Имя	Описание	Тип данных
bdc_file	Обновляемый файл BDC.	File
visible_geometry (Дополнительный)	Определяет, будут ли поля, используемые для идентификации геометрии, включены (видимы) в качестве полей для анализа при использовании файла BDC в других инструментах геообработки. Если поля геометрии невидимы, геометрия все равно будет применяться к набору. Настройку видимости геометрии можно изменить в BDC. GEOMETRY_VISIBLE—Поля геометрии будут включены в качестве полей для анализа. Это значение по умолчанию GEOMETRY_NOT_VISIBLE—Поля геометрии не будут включены в качестве полей для анализа.	Boolean
visible_time (Дополнительный)	Определяет, будут ли поля, используемые для задания времени, включены (видимы) в качестве полей для анализа при использовании файла BDC в других инструментах геообработки. Если поля времени невидимы, время все равно будет применяться к набору. Настройку видимости времени можно изменить в BDC. TIME_VISIBLE—Поля времени будут включены в качестве полей для анализа. Это значение по умолчанию TIME_NOT_VISIBLE—Поля времени не будут включены в качестве полей для анализа.	Boolean

Производные выходные данные

Имя	Описание	Тип данных
updated_bdc	Входной файл .bdc с обновленными наборами данных.	File

Пример кода

RefreshBDC (автономный скрипт)

Скрипт 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)

Параметры среды

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

• Basic: Нет
• Standard: Нет
• Advanced: Да