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

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

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

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

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

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

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

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

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

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

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

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

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

    Проблема	Решение	Пример
    Формат наборов данных не отвечает требованиям.	Откройте файл, чтобы убедиться, что он выглядит как ожидается. Если структура данных неверна, обновите его и повторите попытку.	Файл .csv содержит несколько строк и описание данных, затем только пустые строки.
    Схемы наборов данных в папке не совпадают.	Все файлы в папке набора данных должны иметь одинаковую схему. Откройте файлы и сравните схемы. Исправьте не совпадающие схемы и снова попробуйте зарегистрировать набор данных.	Один файл .csv содержит 10 полей, другой - только 8.
    Типы файлов набора данных в папке не совпадают.	Все файлы в папке набора данных должны иметь одно расширение (тип файла). Проверьте типы файлов в источнике данных и удалите или переместите лишние.	Набор данных шейп-файла - это та же папка, что и файл Parquet.
    Не распознается формат полей.	Это происходит редко, но может случиться, если ORC и Parquet используют необычный формат. Убедитесь, что вы используете допустимые форматы полей.	Используется файл Parquet с неизвестным форматом поля.

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

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

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

  • Копировать набор данных из подключения к многофайловым объектам - копирует набор данных из MFC в класс объектов.
  • Дублировать набор данных из подключения к многофайловым объектам - создает представление имеющегося набора данных MFC.
  • Удалить набор данных из подключения к многофайловым объектам - удаляет набор данных из MFC.
  • Обновить свойства набора данных подключения к многофайловым объектам - изменяет свойства отдельного набора данных MFC.
  • Предварительный просмотр набора данных из подключения к многофайловым объектам – предварительный просмотр первых десяти объектов в наборе данных, чтобы убедиться в их правильной регистрации.
  • Описать набор данных - чтобы убедиться в том, что обновленный набор данных вас устраивает.

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

Параметры

Диалог

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

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

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

Python

arcpy.gapro.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)

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

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

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

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