# Подключение к источникам данных в скриптах загрузки

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

В списке Подключения к данным перечислены сохраненные подключения, упорядоченные в алфавитном порядке и объединенные в группы по пространствам, к которым они принадлежат. С помощью поля поиска можно сократить список подключений, например, отображать только подключения с определенным именем или одного типа. Чтобы открыть Подключения к данным, щелкните Источники данных.

Примечание к информацииМожно увидеть только свои подключения к данным или те, к которым предоставлены права доступа. При необходимости обратитесь к системному администратору Qlik Sense для получения доступа.



## Создание нового подключения к данным

Выполните следующие действия.

1. Щелкните Источники данных.

2. Щелкните команду Создать новое подключение.

3. В поле Пространство выберите пространство, где будет находиться подключение.

4. Выберите тип источника данных, которые необходимо создать, из раскрывающегося списка.

   Откроется диалоговое окно настроек с учетом типа выбранного источника данных.

5. Введите настройки источника данных и щелкните команду Сохранить для создания соединения с данными.

## Удаление подключения к данным

Выполните следующие действия.

1. Щелкните Источники данных.

2. Щелкните элемент the Удалить icon на соединении с данными, которое требуется удалить.

3. Подтвердите удаление данного подключения.

Подключение к данным будет удалено.

## Изменение подключения к данным

Выполните следующие действия.

1. Щелкните Источники данных.

2. В разделе Подключения к данным выберите пространство, содержащее подключение к данным, которое требуется изменить.

3. Щелкните элемент the Изменить icon на подключении к данным, которое требуется изменить.

4. Измените информацию о соединении с данными. Детали подключения у каждого типа подключения свои.

   Может потребоваться предоставить учетные данные подключения.

Подключение к данным теперь обновлено.

Примечание к информацииПри изменении имени подключения к данным необходимо также изменить все существующие ссылки (lib://) на подключение к скрипту, если необходимо сохранить ссылку на это подключение.

## Редактирование учетных данных подключения к данным

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

Дополнительные сведения см. в документации по коннекторам в разделе [Источники данных в Аналитика Qlik Cloud](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Helpsites/Connectors_SaaS.htm).

Выполните следующие действия.

1. Щелкните Источники данных.

2. В разделе Подключения к данным выберите пространство, содержащее подключение к данным.

3. Нажмите the Изменить данные доступа icon на подключении, для которого включены учетные данные, определяемые пользователем.

   Откроется диалоговое окно.

4. В выпадающем меню выберите набор учетных данных, который нужно изменить, или создайте новый.

   Вы также можете удалить сохраненные учетные данные.

5. Измените параметры учетных данных.

6. Нажмите Применить.

## О подключениях DataFiles

Подключения DataFiles автоматически создаются для каждого пространства, к которому имеется доступ. Подключения доступны из любого пространства в разделе Подключения данных.

Примечание к информацииПри вводе расширения файла подключений DataFiles учитывается регистр. Например: .qvd.

## Выбор данных из соединения с данными

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

1. Щелкните Источники данных.

2. Связать параметр Создать новое подключение с источником данных (если подключения к данным еще нет).

3. the Выборка данных icon Выбрать данные из подключения.

## Ссылка на подключение к данным в скрипте

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

В следующем списке изложены правила ссылок на файлы данных в скриптах загрузки в Аналитика Qlik Cloud:

* Синтаксис для ссылки на файл в скрипте загрузки:

  [lib://(имя\_пространства):DataFiles/(имя\_папки)/(имя\_файла)]

* Если имя пространства опущено, используется текущее пространство. Примеры см. в разделе [Источники данных для приложений в управляемых пространствах](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/app-data-managed-spaces.htm).

* Необходимо указать полный путь к папке. Относительные пути не поддерживаются.

* Путь к папке может включать несколько папок в иерархической структуре. Каждое имя\_папки в пути должно быть разделено символами /.

* Следующее не допускается в пути при ссылке на файлы, находящиеся в структуре папок:

  * `//`

  * `\`

  * `\\`

  * `/./`

  * `/../`

* Завершающие символы точки (`.`) в имени пространства, папки или файла допустимы, если они не появляются в конфигурациях из приведенного выше списка.

* Необходимо ссылаться на базовый файл данных, а не на набор данных для файла. Набор данных может иметь имя, отличное от имени его базового файла данных. Для получения дополнительной информации о различиях между файлами данных и наборами данных см. [Отличия между файлами данных и наборами данных](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Catalog/data-files-and-datasets.htm).

Примеры: Недопустимый синтаксис

Эти примеры считаются недопустимым синтаксисом для пути:

```
Load [Transactions] from 'lib:\\Demo:DataFiles\Sales2024\France.qvd';
```

```
store [Transactions] into 'lib://Demo:DataFiles/Sales2024/./France.qvd';
```

```
Load [Transactions] from 'lib://Demo:DataFiles/Sales2024/../France.qvd';
```

```
store [Transactions] into 'lib://Demo:DataFiles//Sales2024//France.qvd';
```

В зависимости от типа используемого оператора скрипта недопустимый синтаксис может привести к сбою перезагрузки или все равно может быть выполнен с другим поведением. Для получения подробной информации см.:

* [Загрузка данных из файлов](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/manage-data-files-spaces.htm)

* [Сохранение данных в файлы](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/manage-data-files-spaces.htm)

Нет необходимости добавлять space\_name при подключении к личному пространству.

Пример: загрузка файла из подключения DataFiles

В этом примере загружен файл orders.csv из личного пространства, определенного в подключении к данным Data.

```
LOAD * FROM [lib://DataFiles/orders.csv];
```

В этом примере загружен файл orders.csv из общего пространства, определенного в подключении к данным Data.

```
LOAD * FROM [lib://TeamSharedConnection:DataFiles/orders.csv];
```

Этот пример загружает файл orders\_Europe.csv из папки Orders By Region в личном пространстве.

```
LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv];
```

Этот пример загружает файл orders\_Europe.csv из папки Orders By Region в общем, управляемом пространстве или в пространстве данных. Имя пространства ― SalesSpace.

```
LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv];
```

В этом примере загружен файл orders.csv из текущего пространства. Если, например, приложение будет перемещено в другое пространство, оно будет использовать файл orders.csv в новом пространстве.

```
LOAD * FROM [lib://:DataFiles/orders.csv];
```

Пример: загрузка из базы данных в личное пространство текущего пользователя

В этом примере загружена таблица Sales\_data из подключения к базе данных DataSource в личное пространство пользователя.

```
LIB CONNECT TO 'DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;
```

Пример: Загрузка из базы данных в другое пространство

В этом примере загружена таблица Sales\_data из подключения к базе данных DataSource в текущем пространстве.

```
LIB CONNECT TO ':DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;
```

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

В этом примере загружена таблица Sales\_data из подключения к базе данных DataSource в пространстве SalesSpace.

```
LIB CONNECT TO 'SalesSpace:DataSource';
LOAD *;
SQL SELECT * FROM `Sales_data`;
```

Примеры: Загрузка из аналитических подключений

Следующие примеры демонстрируют порядок написания выражений для загрузки данных из аналитических коннекторов. Используйте синтаксис SSE, чтобы подключиться к данным из аналитического подключения.

Эти примеры демонстрируют использование подключений в скриптах. Для ознакомления с примерами ссылок на аналитические подключения в диаграммах см. раздел [Использование аналитических подключений и синтаксиса серверных расширений](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/load-data-from-advanced-analytic-connections.htm#Using).

Загрузка из аналитического подключения в текущее пространство

```
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":":Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});
```

Загрузка из аналитического подключения в личное пространство текущего пользователя

```
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});
```

Загрузка из аналитического подключения в конкретное пространство

Этот пример загружает данные из подключения под именем Amazon\_Titan\_(Amazon\_Bedrock) в пространство SalesSpace.

```
EXTENSION endpoints.ScriptEval('{"RequestType":"endpoint", "endpoint":{"connectionname":"SalesSpace:Amazon_Titan_(Amazon_Bedrock)"}}', QuestionsTable{Question_ID,Question});
```

Связанные учебные материалы:

* [Введение в редактор загрузки данных](https://help.qlik.com/lnk/Intro_Data_Load_Editor_QS)
* [Загрузка данных из базы данных](https://help.qlik.com/lnk/Loading_data_from_database_QS)

## Подробнее

* [Введение в редактор загрузки данных](https://help.qlik.com/lnk/Intro_Data_Load_Editor_QS)
* [Загрузка данных из базы данных](https://help.qlik.com/lnk/Loading_data_from_database_QS)