Использовать параметры запроса

Запросы в Knowledge Studio поддерживают параметры запроса. После написания запросы становятся статичными, параметры в запросе позволяют сделать части запроса динамическими. Параметр запроса — это переменная в запросе, значение которой определяется при запуске запроса. Это позволяет запускать один и тот же запрос с разными значениями без необходимости изменять запрос.

Например, можно написать запрос, чтобы найти все объекты, непрямую связанные с человеком: MATCH (p:Person)-[]-(n), ГДЕ p.Name = "John Doe" RETURN n. Параметры запроса заменяют John Doe переменной $name, которая может быть настроена на любое имя: MATCH (p:Person)-[]-(n), WHERE p.Name = $name RETURN n. Панель Параметры в виде запроса позволяет определить параметр $name и затем изменить его значение без изменения запроса.

Тип параметра	Описание
Строка	Любой набор буквенно-цифровых символов.
Число	Соответствует свойствам графа любого числового типа, кроме большого целого (Big Integer). Примечание: Knowledge Studio поддерживает только безопасные целые числа, которые находятся в диапазоне от -9007199254740991 (минимум) до 9007199254740991 (максимум). Числа за пределами этого диапазона будут неверными из-за округления, поэтому не будут соответствовать полям Big Integer в графе знаний.
Геометрия	Задайте геометрию для использования в любом из пространственных операторов, поддерживаемых в запросах. На данный момент поддерживается только прямоугольная геометрия.
Только дата	Только значения дат, без значений времени. Подробнее об использовании значений даты и времени в запросах
Только время	Только значения времени с точностью до секунд, без значений дат Подробнее об использовании значений даты и времени в запросах
Дата	Точность определения даты и времени в секундах (низкая точность) или миллисекундах (высокая точность). Подробнее об использовании значений даты и времени в запросах
Сдвиг метки времени	Дата, время и сдвиг относительно Всемирного координированного часового пояса (UTC). Подробнее об использовании значений даты и времени в запросах
Элемент	Элементы в графе знаний.
Отношение	Отношения в графе знаний.

Настроить новые параметры

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

Строковый параметр

Настройте параметр Строка.

1. На контекстной панели инструментов щелкните Параметры.

   Откроется панель Параметры.

2. Щелкните Создать новый параметр.

   Откроется новая форма Параметр.

3. Назовите свой параметр.
   1. Щелкните меню рядом с заголовком Параметр.
   2. Щелкните Переименовать.
   3. Введите описательное имя параметра в поле Заголовок.
   4. Щёлкните Применить.

   В заголовке для параметра появилось новое имя.

4. Определите параметр во входных данных Параметр привязки, используя один из следующих методов:
   • Введите имя параметра в поле ввода.
   • Если вы написали запрос, содержащий параметры, выберите нужный параметр из ниспадающего списка.
5. Выберите Строка из ниспадающего списка Тип
6. Введите строку в поле ввода для использования в качестве начального значения параметра. По умолчанию используется Одно значение, см. раздел Определение списка значений, чтобы задать список значений для параметра.
7. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Параметр Число

Настройка параметра Число

1. На контекстной панели инструментов щелкните Параметры.

   Откроется панель Параметры.

2. Щелкните Создать новый параметр.

   Откроется новая форма Параметр.

3. Назовите свой параметр.
   1. Щелкните меню рядом с заголовком Параметр.
   2. Щелкните Переименовать.
   3. Введите описательное имя параметра в поле Заголовок.
   4. Щёлкните Применить.

   В заголовке для параметра появилось новое имя.

4. Определите параметр во входных данных Параметр привязки, используя один из следующих методов:
   • Введите имя параметра в поле ввода.
   • Если вы написали запрос, содержащий параметры, выберите нужный параметр из ниспадающего списка.
5. Выберите Число в ниспадающем списке Тип
6. Введите число в поле ввода, которое будет использоваться в качестве начального значения параметра. По умолчанию используется Одно значение, см. раздел Определение списка значений, чтобы задать список значений для параметра.
7. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Параметр геометрии

Настроить параметр Геометрия.

Подробнее о пространственных операторах в запросах.

1. На контекстной панели инструментов щелкните Параметры.

   Откроется панель Параметры.

2. Щелкните Создать новый параметр.

   Откроется новая форма Параметр.

3. Назовите свой параметр.
   1. Щелкните меню рядом с заголовком Параметр.
   2. Щелкните Переименовать.
   3. Введите описательное имя параметра в поле Заголовок.
   4. Щёлкните Применить.

   В заголовке для параметра появилось новое имя.

4. Определите параметр во входных данных Параметр привязки, используя один из следующих методов:
   • Введите имя параметра в поле ввода.
   • Если вы написали запрос, содержащий параметры, выберите нужный параметр из ниспадающего списка.
5. Выберите Геометрия в ниспадающем списке Тип
6. Щелкните Задать геометрию, чтобы определить начальное значение для параметра. По умолчанию используется Одно значение, см. раздел Определение списка значений, чтобы задать список значений для параметра. .

   Откроется режим геометрии скетча.

7. Щелкните инструмент Прямоугольник на графической панели инструментов.
8. Щелкните и перетащите курсор мыши на карту, чтобы нарисовать прямоугольник вокруг области интереса.

   При настройке списка геометрий выполните этот шаг для каждой геометрии.

9. Или выберите геометрию одним из следующих способов на панели инструментов графики.
   • Выбрать объект — щелкните объект для его выбора.
   • Выбрать прямоугольником — щелкните на карте и перетащите прямоугольник вокруг объекта, чтобы выбрать его.
   • Выбрать лассо — щелкните карту или диаграмму связей и наведите указатель, чтобы сделать выборку линией произвольной формы.
10. По желанию измените или удалите объект:
    • измените размер объекта, щелкнув один из прямоугольников по граням или углам и перетащив его для изменения размера.
    • переместите объект, щелкнув в любом месте объекта и перетащив его в новое место на карте.
    • Щелкните Удалить объект на графической панели инструментов, чтобы удалить этот объект.
    • Щелкните Очистить, чтобы перенастроить карту.
11. Нажмите ОК
12. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Только дата

Настройте параметр Только дата.

Подробнее об использовании значений даты и времени в запросах

1. На контекстной панели инструментов щелкните Параметры.

   Откроется панель Параметры.

2. Щелкните Создать новый параметр.

   Откроется новая форма Параметр.

3. Назовите свой параметр.
   1. Щелкните меню рядом с заголовком Параметр.
   2. Щелкните Переименовать.
   3. Введите описательное имя параметра в поле Заголовок.
   4. Щёлкните Применить.

   В заголовке для параметра появилось новое имя.

4. Определите параметр во входных данных Параметр привязки, используя один из следующих методов:
   • Введите имя параметра в поле ввода.
   • Если вы написали запрос, содержащий параметры, выберите нужный параметр из ниспадающего списка.
5. Выберите Только дата из ниспадающего списка Тип
6. Задайте дату, которая будет использоваться для этого значения. По умолчанию используется Одно значение, см. раздел Определение списка значений, чтобы задать список значений для параметра. Определите дату, используя один из следующих методов:
   • Введите дату в поле ввода в формате MM/DD/YYYY.
   • Щелкните поле ввода и выберите дату с помощью календаря.
7. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Только время

Настройте параметр Только время.

Подробнее об использовании значений даты и времени в запросах

1. На контекстной панели инструментов щелкните Параметры.

   Откроется панель Параметры.

2. Щелкните Создать новый параметр.

   Откроется новая форма Параметр.

3. Назовите свой параметр.
   1. Щелкните меню рядом с заголовком Параметр.
   2. Щелкните Переименовать.
   3. Введите описательное имя параметра в поле Заголовок.
   4. Щёлкните Применить.

   В заголовке для параметра появилось новое имя.

4. Определите параметр во входных данных Параметр привязки, используя один из следующих методов:
   • Введите имя параметра в поле ввода.
   • Если вы написали запрос, содержащий параметры, выберите нужный параметр из ниспадающего списка.
5. Выберите Только время в ниспадающем списке Тип
6. Установите время, которое будет использоваться для значения. . По умолчанию используется Одно значение, см. раздел Определение списка значений, чтобы задать список значений для параметра. Определите время, используя один из следующих методов:
   • Введите время в поле ввода в формате HH:MM:SS.SSS.
   • Или можете указать время с помощью средства выбора времени.
7. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Дата

Настройте параметр Дата.

Подробнее об использовании значений даты и времени в запросах

1. На контекстной панели инструментов щелкните Параметры.

   Откроется панель Параметры.

2. Щелкните Создать новый параметр.

   Откроется новая форма Параметр.

3. Назовите свой параметр.
   1. Щелкните меню рядом с заголовком Параметр.
   2. Щелкните Переименовать.
   3. Введите описательное имя параметра в поле Заголовок.
   4. Щёлкните Применить.

   В заголовке для параметра появилось новое имя.

4. Определите параметр во входных данных Параметр привязки, используя один из следующих методов:
   • Введите имя параметра в поле ввода.
   • Если вы написали запрос, содержащий параметры, выберите нужный параметр из ниспадающего списка.
5. Выберите Дата в ниспадающем списке Тип.
6. Установите дату и время для Значения. По умолчанию используется Одно значение, см. раздел Определение списка значений, чтобы задать список значений для параметра. Определите дату, используя один из следующих методов:
   • Введите дату в поле ввода в формате MM/DD/YYYY.
   • Щелкните поле ввода и выберите дату с помощью календаря.
7. Определите время, используя один из следующих методов:
   • Введите время в поле ввода в формате HH:MM:SS.SSS.
   • Или можете указать время с помощью средства выбора времени.
8. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Параметр сдвига метки времени

Настройте параметр Сдвиг метки времени.

Подробнее об использовании значений даты и времени в запросах

1. На контекстной панели инструментов щелкните Параметры.

   Откроется панель Параметры.

2. Щелкните Создать новый параметр.

   Откроется новая форма Параметр.

3. Назовите свой параметр.
   1. Щелкните меню рядом с заголовком Параметр.
   2. Щелкните Переименовать.
   3. Введите описательное имя параметра в поле Заголовок.
   4. Щёлкните Применить.

   В заголовке для параметра появилось новое имя.

4. Определите параметр во входных данных Параметр привязки, используя один из следующих методов:
   • Введите имя параметра в поле ввода.
   • Если вы написали запрос, содержащий параметры, выберите нужный параметр из ниспадающего списка.
5. Выберите Сдвиг метки времени в ниспадающем списке Тип
6. Установите для Значения дату, время и сдвиг от UTC. По умолчанию используется Одно значение, см. раздел Определение списка значений, чтобы задать список значений для параметра. Определите дату, используя один из следующих методов:
   • Введите дату в поле ввода в формате MM/DD/YYYY.
   • Щелкните поле ввода и выберите дату с помощью календаря.
7. Определите время, используя один из следующих методов:
   • Введите время в поле ввода в формате HH:MM:SS.SSS.
   • Или можете указать время с помощью средства выбора времени.
8. Введите количество минут для сдвига часового пояса относительно UTC.

   Значение по умолчанию равно нулю. Минимальное значение составляет -720 (-12:00 часов), а максимальное — 840 (+14:00 часов).

9. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Элемент или Отношение

Настройте параметр Элемент или Отношение. При настройке параметра элемент или отношение используется уникальный идентификатор элемента или отношения.

Например, MATCH (p:Person)-[]-(m) WHERE ID(p) = $entityOrRelationshipUniqueID

1. На контекстной панели инструментов щелкните Параметры.

   Откроется панель Параметры.

2. Щелкните Создать новый параметр.

   Откроется новая форма Параметр.

3. Назовите свой параметр.
   1. Щелкните меню рядом с заголовком Параметр.
   2. Щелкните Переименовать.
   3. Введите описательное имя параметра в поле Заголовок.
   4. Щёлкните Применить.

   В заголовке для параметра появилось новое имя.

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

   Появится ниспадающий список с пятью наиболее подходящими записями. По мере ввода список будет обновляться.

7. Выберите запись из ниспадающего списка.
8. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Используйте списки для значений параметров

Любой параметр может быть списком значений, но этот список может содержать только один тип значений. Например, чтобы найти всех людей с общими фамилиями, можно использовать запрос MATCH (p:People) where n.lastName in $lastNameList RETURN n и определить lastNameList как строковый список, содержащий Smith, Jones и Johnson используя панель параметров.

Если имеется список значений с разделителями, например список имен, разделенных запятыми, выберите список из текста, чтобы добавить значения в список.

Задание списка значений

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

1. Щелкните Список значений, чтобы задать список значений для параметра.
2. Используйте тот же метод ввода, что и для одного значения выбранного типа (начиная с шестого шага). Или ознакомьтесь с кратким описанием шагов для каждого типа в таблице ниже.

   Строка	Введите строку в поле ввода.
   Число	Введите число в поле ввода Примечание: Knowledge Studio поддерживает только безопасные целые числа, которые находятся в диапазоне от -9007199254740991(минимум)до 9007199254740991(максимум). Числа за пределами этого диапазона будут неверными из-за округления, поэтому не будут соответствовать полям Big Integer в графе знаний.
   Геометрия	Щелкните Задать геометрию и нарисуйте несколько геометрий
   Только дата	Введите дату в формате MM/DD/YYYY или воспользуйтесь календарем для ввода даты.
   Только время	Введите время в формате HH:MM:SS.sss или воспользуйтесь средством выбора времени для ввода времени
   Дата	Введите дату в формате HH:MM:SS.sss или воспользуйтесь календарем для ввода даты. Введите время в формате MM/DD/YYYY или воспользуйтесь средством выбора времени для ввода времени
   Сдвиг метки времени	Введите дату в формате HH:MM:SS.sss или воспользуйтесь календарем для ввода даты. Введите время в формате MM/DD/YYYY или воспользуйтесь средством выбора времени для ввода времени. Введите сдвиг по времени от UTC в минутах.
   Элемент	Используйте поле ввода, чтобы найти и выбрать элемент.
   Отношение	Используйте поле ввода, чтобы найти и выбрать отношение.

3. Щёлкните Добавить
4. Повторяйте первый и второй шаги до тех пор, пока все значения не будут добавлены в список.
5. При необходимости можно управлять значениями в списке.
   • Щелкните заголовок Значения, чтобы отобразить значения в списке.
   • Щёлкните Очистить рядом со значением, чтобы удалить его из списка.
   • Щелкните Очистить, чтобы очистить список.
   • Щелкните Копировать, чтобы скопировать значения из списка в системный буфер обмена.
6. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Пользовательский список из текста

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

1. Щелкните Список из текста.

   Откроется модальное окно Список из текста.

2. В поле Разделитель введите символ или символы для разделения значений в списке. По умолчанию это запятая. Если список разделен табуляцией или новой строкой (Enter), щелкните соответствующую опцию.
3. Вставьте список с разделителями в текстовое поле.

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

4. Щелкните Построить список.

   Список результатов формируется под текстовым полем.

5. Дополнительно можете щелкнуть по списку результатов, чтобы просмотреть их
   1. Также можно щелкнуть крестик X рядом со значением, чтобы удалить его из списка.
6. Либо щелкнуть Очистить, чтобы удалить все значения из списка
7. Щелкните Добавить значения в список, чтобы добавить сгенерированные значения в список параметров.
8. Щёлкните Применить, чтобы запустить запрос с заданными параметрами.

Результаты запроса будут обновлены на основе новых значений параметров.

Удалить параметр

Настроенные параметры можно удалить из запроса.

1. На контекстной панели инструментов щелкните Параметры.

   Откроется панель Параметры.

2. Если откроется панель с вкладкой правки, перейдите на вкладку Настроить.
3. В меню Опции щелкните рядом с именем параметра.

   Откроется меню опций.

4. Нажмите кнопку Удалить.

   Параметр будет удален.

Примечание:

Если запрос по-прежнему содержит параметр, он вернет ошибку при запуске, если только параметр не будет удален из запроса или перенастроен заново.

Редактировать значения

Если параметры были настроены для сохраненного запроса, то при открытии этого запроса автоматически открывается панель Параметры на вкладке Редактировать значения.

1. Если панель Параметры не открыта, щелкните Параметры на контекстной панели инструментов.

   Откроется панель Параметры. Будут перечислены параметры, настроенные для запроса.

2. Обновите значение в зависимости от Типа параметра.

   Тип каждого параметра будет указан под заголовком. Если параметр использует список значений, то Список будет включен после типа. Чтобы обновить значения в списке, обратитесь к разделу Задание списка значений. Текущие значения, используемые в запросе, будут показаны во входных элементах для каждого параметра. Ниже кратко описаны шаги для каждого типа.

   Строка	Введите строку в поле ввода
   Число	Введите число в поле ввода Примечание: Knowledge Studio поддерживает только безопасные целые числа, которые находятся в диапазоне от -9007199254740991 (минимум) до 9007199254740991(максимум). Числа, которые выходят за пределы этого диапазона, будут неверными из-за округления, поэтому не будут соответствовать полям Big Integer в графе знаний.
   Геометрия	Нажмите Задать геометрию и отрисуйте несколько геометрий
   Только дата	Введите дату в формате MM/DD/YYYY или воспользуйтесь календарем для ввода даты.
   Только время	Введите время в формате HH:MM:SS.sss или воспользуйтесь средством выбора времени для ввода времени
   Дата	Введите дату в формате HH:MM:SS.sss или воспользуйтесь календарем для ввода даты. Введите время в формате MM/DD/YYYY или воспользуйтесь средством выбора времени для ввода времени
   Сдвиг метки времени	Введите дату в формате HH:MM:SS.sss или воспользуйтесь календарем для ввода даты. Введите время в формате MM/DD/YYYY или воспользуйтесь средством выбора времени для ввода времени. Введите сдвиг по времени от UTC в минутах.
   Элемент	Используйте поле ввода, чтобы найти и выбрать элемент.
   Отношение	Используйте поле ввода, чтобы найти и выбрать отношение.

3. Щёлкните Применить, чтобы запустить запрос с обновленными значениями.

Результаты запроса будут обновлены на основе новых значений параметров.