Обновить подключение к многофайловым объектам (GeoAnalytics Desktop)

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

Обновляет существующее подключение к многофайловым объектам (MFC) и регистрирует все новые наборы данных, были добавленные в исходное местоположение.

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

  • Этому инструменту требуется MFC. Чтобы создать MFC, используйте инструмент Создание подключений к многофайловым объектам.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Инструмент Обновить подключение к многофайловым объектам идентифицирует новые наборы данных. Для изменения MFC также можно использовать и следующие инструменты:

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

Параметры

ПодписьОписаниеТип данных
Файл подключения к многофайловым объектам

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

File
Видимые поля геометрии
(Дополнительный)

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

  • Отмечено - поля геометрии будут включены в качестве полей для анализа. Это значение по умолчанию
  • Не отмечено - поля геометрии не будут включены в качестве полей для анализа.

Boolean
Видимые поля времени
(Дополнительный)

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

  • Отмечено - поля времени будут включены в качестве полей для анализа. Это значение по умолчанию
  • Не отмечено - поля времени не будут включены в качестве полей для анализа.

Boolean

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

ПодписьОписаниеТип данных
Обновленный MFC

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

File

arcpy.geoanalytics.RefreshBDC(bdc_file, {visible_geometry}, {visible_time})
ИмяОписаниеТип данных
bdc_file

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

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

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

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

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

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

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

ИмяОписаниеТип данных
updated_bdc

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

File

Пример кода

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

Скрипт Python, демонстрирующий использование функции RefreshBDC.

# Name: RefreshBDC.py
# Description: Refreshes a multifile feature connection to automatically discover datasets that 
#              have been added.
#
# Requirements: ArcGIS Pro Advanced License

# Import system modules
import arcpy

# Set local variables
mfcFile = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc"

# Run Refresh Multifile Feature Connection
arcpy.gapro.RefreshBDC(mfcFile)

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

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