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

Сводка

Обновляет существующее соединение больших данных (BDC) и регистрирует все новые наборы данных, которые были добавлены в исходное местоположение.

Использование

  • Для этого инструмента требуется BDC. Чтобы создать BDC, воспользуйтесь инструментом Создать подключение больших данных.

  • Воспользуйтесь этими инструментами, чтобы добавить один или несколько новых наборов данных к существующему подключению больших данных. Кроме того, инструмент зарегистрирует наборы данных, удаленные инструментом Удалить набор данных из подключения больших данных. Ниже приведены потенциальные варианты применения этого инструмента:

    • Вы скопировали папку с данными в имеющуюся папку исходного BDC и собираетесь отобразить ее в виде набора данных в BDC.
    • Вы воспользовались инструментом Удалить набор данных из подключения больших данных и собираетесь снова добавить удаленные наборы данных BDC.

  • Этот инструмент не обновляет свойства существующего набора данных, отредактированные инструментом Обновить свойства набора данных подключения больших данных. Все изменения свойств будут сохранены. Для следующих сценариев есть рекомендуемые рабочие процессы:

  • Сообщения инструмента будут содержать следующую информацию об обнаруженных наборах данных и их статусе:

    • Пропущено - все существующие наборы данных пропускаются во время обновления и остаются как есть.
    • Успешно - новые наборы данных, которые были обнаружены и добавлены в BDC.
    • Сбой - наборы данных, которые не удалось добавить в BDC.

    При поиске наборов данных в BDC может возникнуть две проблемы:

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

      ПроблемаРешениеПример

      Формат наборов данных не отвечает требованиям.

      Откройте файл, чтобы убедиться, что он выглядит как ожидается. Если структура данных неверна, обновите его и повторите попытку.

      Файл .csv содержит несколько строк и описание данных, затем только пустые строки.

      Схемы наборов данных в папке не совпадают.

      Все файлы в папке набора данных должны иметь одинаковую схему. Откройте файлы и сравните схемы. Исправьте не совпадающие схемы и снова попробуйте зарегистрировать набор данных.

      Один файл .csv содержит 10 полей, другой - только 8.

      Типы файлов набора данных в папке не совпадают.

      Все файлы в папке набора данных должны иметь одно расширение (тип файла). Проверьте типы файлов в источнике данных и удалите или переместите лишние.

      Набор данных шейп-файла - это та же папка, что и файл Parquet.

      Не распознается формат полей.

      Это происходит редко, но может случиться, если ORC и Parquet используют необычный формат. Убедитесь, что вы используете допустимые форматы полей.

      Используется файл Parquet с неизвестным форматом поля.

    Подробнее о том, почему наборы данных не удастся добавить в файл BDC

  • После обновления вами BDC запустите инструмент Описать набор данных, чтобы убедиться в том, что обновленный набор данных вас устраивает.

  • Инструмент Обновить подключение больших данных находит новые наборы данных. Для изменения BDC могут использоваться и следующие инструменты:

  • Этот инструмент геообработки работает от Spark. Чтобы изучить вопросы, посвященные подключениям больших данных и работе с ними, см. раздел Подключения больших данных.

Синтаксис

arcpy.gapro.RefreshBDC(bdc_file, {visible_geometry}, {visible_time})
ParameterОбъяснениеТип данных
bdc_file

Обновляемый файл BDC.

File
visible_geometry
(Дополнительный)

Определяет, будут ли поля, используемые для идентификации геометрии, включены (видимы) в качестве полей для анализа при использовании файла BDC в других инструментах геообработки. Если поля геометрии невидимы, геометрия все равно будет применяться к набору. Настройку видимости геометрии можно изменить в BDC.

  • GEOMETRY_VISIBLEПоля геометрии будут включены в качестве полей для анализа. Это значение по умолчанию.
  • GEOMETRY_NOT_VISIBLEПоля геометрии не будут включены в качестве полей для анализа.
Boolean
visible_time
(Дополнительный)

Определяет, будут ли поля, используемые для задания времени, включены (видимы) в качестве полей для анализа при использовании файла BDC в других инструментах геообработки. Если поля времени невидимы, время все равно будет применяться к набору. Настройку видимости времени можно изменить в BDC.

  • TIME_VISIBLEПоля времени будут включены в качестве полей для анализа. Это значение по умолчанию.
  • TIME_NOT_VISIBLEПоля времени не будут включены в качестве полей для анализа.
Boolean

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

NameОбъяснениеТип данных
updated_bdc

Входной файл .bdc с обновленными наборами.

Файл

Пример кода

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)

Environments

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

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

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

Связанные разделы