ArcMap

Создать слой запроса

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

Создает слой запроса из таблицы СУБД на основании входного SQL-выражения выборки.

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

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

  • Если результирующий SQL-запрос вернется в виде пространственного столбца, то на выходе будет слой пространственных объектов. Если SQL-запрос не вернется в виде пространственного столбца, то на выходе будет автономная таблица.

  • Необходимые для этого инструмента файлы подключения можно создать с помощью инструмента Создать подключение базы данных.

  • Если результирующий SQL-запрос не возвращает ни одной строки, выходной слой запроса будет пустым и будет содержать только схему столбцов, полученных в результате запроса. В таком случае, если полученные столбцы содержат пространственный столбец, для создания слоя запроса инструмент будет использовать следующие значения по умолчанию:
    • Тип геометрии – POINT
    • SRID – 1
    • пространственная привязка – NAD1983

    В дальнейшем перед запуском инструмента пользователь сможет изменить эти значения на свое усмотрение.

  • Для географических данных каждая запись, возвращенная результирующим SQL-выражением, должна иметь соответственный SRID (идентификатор пространственной привязки). База данных использует значение SRID для определения пространственной привязки для своих данных. Для разных СУБД платформ имеются определенные функциональные различия в SRID. Некоторые СУБД платформы поддерживают множественные значения SRID в пределах одной таблицы, ArcGIS поддерживает только одно значение. Этот инструмент предоставляет возможность выбора значения SRID или устанавливает значение SRID по умолчанию на основании первой записи в результирующем наборе.

Синтаксис

MakeQueryLayer_management (input_database, out_layer_name, query, {oid_fields}, {shape_type}, {srid}, {spatial_reference})
ПараметрОбъяснениеТип данных
input_database

Файл подключения базы данных, который содержит данные для запроса.

Workspace
out_layer_name

Выходное имя, которое будет создано для слоя пространственных объектов или представления таблицы.

String
query

SQL-выражение, которое определяет выбранный запрос для обращения к базе данных.

String
oid_fields
[oid_fields,...]
(Дополнительный)

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

String
shape_type
(Дополнительный)

Тип формы для слоя запроса. В выходном слое запроса используются только те записи из результирующего набора запроса, которые соответствуют указанному типу геометрии. Проверка инструмента попытается установить это свойство на основании первой записи в результирующем наборе. Если такой тип выходной формы не является желательным, его можно изменить перед запуском инструмента. Если результирующий набор запроса не возвращает поле геометрии, этот параметр игнорируется.

  • POINT —Выходной слой запроса использует точечную геометрию.
  • MULTIPOINT —Выходной слой запроса использует мультиточечную геометрию.
  • POLYGON —Выходной слой запроса использует полигональную геометрию.
  • POLYLINE —Выходной слой запроса использует полилинейную геометрию.
String
srid
(Дополнительный)

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

String
spatial_reference
(Дополнительный)

Устанавливает систему координат, которая используется выходным слоем запроса. Проверка инструмента попытается установить это свойство на основании первой записи в результирующем наборе. Если такая выходная система координат не является желательной, ее можно изменить перед запуском инструмента. Если результирующий набор запроса не возвращает поле геометрии, этот параметр игнорируется.

Spatial Reference

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

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

Пример кода

MakeQueryLayer, пример 1 (окно Python)

Следующий скрипт окна Python показывает, как использовать инструмент MakeQueryLayer в режиме прямого запуска.

import arcpy

sr = arcpy.SpatialReference("WGS 1984 UTM Zone 12N")

arcpy.MakeQueryLayer_management("Connections/moab.sde",
                                "Slickrock",
                                "select * from moabtrails where name = 'slickrock'",
                                "OBJECTID",
                                "POLYLINE",
                                "32611",
                                sr)
MakeQueryLayer, пример 2 (автономный скрипт)

В следующем автономном скрипте показано, как использовать инструмент MakeQueryLayer.

# Name: MakeQueryLayer.py
# Description: Creates an output query layer based on a where clause.
#   This example shows how to create a spatial reference object using the
#   name of a coordinate system. It also demonstrates how to use two fields
#   to generate a dynamic unique row identifier for the query layer.


# Import system modules
import arcpy

# Create the spatial reference for the output layer.
sr = arcpy.SpatialReference("WGS 1984 UTM Zone 12N")

# Run the tool
arcpy.MakeQueryLayer_management("Connections/moab.sde",
                                "Single Track",
                                "select * from moabtrails where type = 'single'",
                                "UID;name",
                                "POLYLINE",
                                "32611",
                                sr)

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

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

  • ArcGIS Desktop Basic: Да
  • ArcGIS Desktop Standard: Да
  • ArcGIS Desktop Advanced: Да

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