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

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

Обновляет существующее подключение к многофайловым объектам (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

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)

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

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

Отзыв по этому разделу?

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

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

Параметры

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

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

Пример кода

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

В этом разделе