Можно создавать, обновлять, удалять и совместно использовать подключения к источникам данных. Как пользователь Oracle Analytics с правами доступа "Создатель контента DV", вы можете выполнять указанные ниже действия.
Разделы:
Вы можете создать соединение, которое позволит анализировать данные в этом источнике данных.
Можно обновить сведения о подключении источника данных.
Если при редактировании SSL-подключения к базе данных Oracle необходимо использовать новый файл cwallet.sso
, в поле Накопитель клиента нажмите Выбрать, чтобы найти и выбрать файл cwallet.sso
. Узнайте расположение файла cwallet.sso
у администратора.
Подключение к источнику данных можно удалить из Oracle Analytics Cloud. Например, необходимо удалить существующее подключение и создать новое, если изменился пароль базы данных.
Если подключение содержит наборы данных, перед удалением подключения необходимо удалить эти наборы.
Созданным или администрируемым подключениям к источникам данных можно назначить разрешения доступа.
При указании сведений о подключении в диалоговом окне "Создание подключения" или в диалоговом окне "Проверка" можно заметить, что некоторые типы баз данных имеют дополнительные параметры конфигурации.
Общие параметры
sales.example.com =(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.111)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.222)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.333)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME= salesservice.example.com)))
Включить массовую репликацию. Если загружается набор данных для рабочей книги, эту настройку следует отключить и можно игнорировать. Этот параметр зарезервирован для аналитиков и опытных пользователей, выполняющих репликацию из одной базы данных в другую.
Параметры аутентификации
Системное подключение
Нажмите Копировать, чтобы скопировать Идентификатор объекта подключения. Разработчики бизнес-моделей могут вставлять Идентификатор объекта для определения и использования подключения к данным в инструменте администрирования моделей (диалоговое окно "Пул подключений").
Примечание. Если при первоначальном создании подключения не выбрано Системное подключение, то позже, если вы захотите, чтобы построители моделей данных использовали сведения о подключении, потребуется создать новое подключение и выбрать Системное подключение. Другими словами, вы не сможете изменить подключение позже и выбрать этот параметр.
Перед созданием подключения к базе данных изучите требования к подключению к базе данных.
Максимальное число отображаемых таблиц базы данных в Oracle Analytics равно 10 000. При необходимости создания дополнительных таблиц Oracle рекомендует администратору базы данных создать пользователя базы данных с доступом к определенным объектам, которые необходимо проанализировать, и указать учетные данные этого пользователя при создании подключения к базе данных.
При подключении к базе данных Oracle, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server или My SQL можно изменить идентификатор кавычек по умолчанию для считывания данных в верхнем, нижнем или смешанном регистре в именах таблиц или столбцов.
select "EfG_Field" from "AbCd";
вместо выдачи select EfG_Field" from "AbCd;
, (что приводит к сбою).С помощью REST API для Oracle Analytics Cloud можно управлять подключениями к различными источникам данных, используя программные средства. Например, можно написать сценарий для создания или изменения одинакового набора подключений в тестовой и производственной среде Oracle Analytics Cloud.
Подключения к источникам данных можно создавать, обновлять и удалять с помощью REST API. В этом разделе перечислены типы подключений к источникам данных, которыми можно управлять с помощью REST API.
Примечание.:
В руководстве REST API для Oracle Analytics Cloud приведена подробная информация о каждом API-интерфейсе REST. См. раздел "Конечные точки REST для подключения".Поддерживаемые источники данных
Параметры подключения
Для каждого подключения параметры будут разными. Чтобы создать или изменить подключение с помощью REST API, нужно знать формат полезных данных JSON, необходимый для вашего источника данных. См. раздел "Образцы полезных данных JSON для источников данных".
Здесь приведены наиболее частые задачи, которые приходится решать при использовании REST API Oracle Analytics Cloud для управления подключениями с помощью программных средств. Если вы используете REST API в первый раз, следуйте этим инструкциям в качестве руководства.
Задача | Описание | Документация по AP REST |
---|---|---|
Понимание предварительных требований |
Понимание и выполнение нескольких задач, связанных с предварительными условиями. Для управления подключениями к данным с помощью REST API необходимы права на создание рабочих книг и подключение к данным в Oracle Analytics Cloud (DV Content Author). |
Предварительные условия |
Понимание аутентификации на основе токена OAuth 2.0 | Аутентификация и авторизация в Oracle Analytics Cloud управляются Oracle Identity Cloud Service. Для доступа к API-интерфейсам REST Oracle Analytics Cloud требуется токен доступа OAuth 2.0, который используется для авторизации. | Аутентификация на основе токена OAuth 2.0 |
Общая информация о поддерживаемых источниках данных | Прочитайте раздел, где описаны типы подключений к данным, которыми можно управлять с помощью REST API. | Поддерживаемые источники данных |
Определение форматов полезных данных JSON | Прочитайте раздел с описанием формата полезных данных JSON для вашего источника данных и получите нужные параметры подключения. | Образцы полезных данных JSON для источников данных |
Создание подключения | Создайте подключение к данным, которое будет использоваться в рабочих книгах, отчетах и панелях управления. | Создание подключения (предварительный просмотр) |
Обновление подключения | Обновите свойства существующего подключения к данным. | Обновление подключения (предварительный просмотр) |
Удаление подключения | Удалите подключение к данным. | Удаление подключения (предварительный просмотр) |
Используйте данные образцы и примеры для управления подключениями к источникам данных с помощью запросов API-интерфейса REST с использованием cURL.
Пример формата cURL
curl --header "Authorization: Bearer <token>" --header "Content-Type: application/json" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --data "<data source connection payload>"
curl --header "Authorization: Bearer <token>" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --form "cert=<security wallet file>" --form "connectionParams=<data source connection payload>"
<токен> — требуется токен носителя OAuth 2.0 для аутентификации вызовов REST API Oracle Analytics Cloud. См. раздел "Аутентификация на основе токена OAuth 2.0".
<имя хоста> — хост, где запущено решение Oracle Analytics Cloud.
<полезные данные подключения к источнику> — информация о подключении к конкретному источнику данных. См. раздел "Образцы полезных данных JSON для источников данных".
<файл накопителя защиты> — содержит информацию об SSL-соединении, такую как учетные данные аутентификации и подписи, частные ключи, сертификаты и доверенный сертификат. Требуется для подключений к некоторым источникам, таких как база данных Oracle с настроенным SSL и Oracle Autonomous Data Warehouse (взаимная аутентификация TLS).
Примеры
Следующие примеры показывают, как создать подключение к Oracle Autonomous Data Warehouse (ADW).
cwallet.sso
(взаимная аутентификация TLS)Другие примеры приведены в руководстве REST API для Oracle Analytics Cloud. См. разделы "Создание подключения (предварительный просмотр)", "Обновление подключения (предварительный просмотр)" и "Удаление подключения (предварительный просмотр)".
Примечание.:
Полезные данные JSON в этих примерах приведены для Oracle ADW. Формат полезных данных JSON отличается от других источников данных. См. раздел "Образцы полезных данных JSON для поддерживаемых источников данных".
Пример 1. Создание подключения к Oracle ADW без накопителя (аутентификация TLS)
oracle_adw_walletless
. Тело запроса содержит простой JSON application/json
.
curl --header "Authorization: Bearer <token>" --header "Content-Type: application/json" --request POST https://example.com/api/20210901/catalog/connections --data "{ "version": "2.0.0", "type": "connection", "name": "oracle_adw_walletless", "description": "Пример подключения к Oracle ADW без бумажника, созданного с помощью API подключений", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_adwwalletless_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))", "username": "ADMIN", "password": "<<password>>", "systemConnection": false, "remoteData": false, "sslType": "ServerSideSSL" } } }"
Тело ответа
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Обратите внимание на параметр connectionId
в теле ответа, закодированный Base64. Позднее вы сможете использовать это значение для обновления или удаления соединения.
Пример 2. Создание подключения к Oracle ADW с использованием файла накопителя (взаимная аутентификация TLS)
oracle_adw_with_wallet
. Тело запроса содержит multipart/form-data
, то есть требует и файл накопителя от Oracle ADW (cwallet.sso
), и параметры подключения к Oracle ADW.
curl --header "Authorization: Bearer <token>" -–request POST https://<hostname>/api/20210901/catalog/connections --form "cert=@"/Users/scott/Downloads/Wallet_adw/cwallet.sso"" --form "connectionParams= "{ "version": "2.0.0", "type": "connection", "name": "oracle_adw_with_wallet", "description": "Пример подключения к Oracle ADW с бумажником, созданным с помощью API подключений", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_walletadw_high.adwc.oraclecloud.com/))(security=(ssl_server_dn_match=yes)))", "username": "ADMIN", "password": "<<password>>", "remoteData": "false", "systemConnection": false, "sslType": "ClientSideSSL" } } }"
Тело ответа
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Обратите внимание на параметр connectionId
в теле ответа, закодированный Base64. Позднее вы сможете использовать это значение для обновления или удаления соединения.
Для подключения к источнику данных необходимо указать параметры подключения. При использовании REST API подключений необходимо указать параметры подключения в определенном формате полезных данных JSON. Воспользуйтесь следующей таблицей, чтобы определить полезные данные JSON для источника данных, к которому вы хотите подключиться.
Источник данных | Тип запроса | Полезные данные ввода |
---|---|---|
Oracle Database (Не SSL) |
application/json |
Базовый тип подключения { "version": "2.0.0", "type": "connection", "name": "oracle_db_non_ssl_basic", "description": "Sample non-SSL Oracle Database connection created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-database", "host": "example.com", "port": "1521", "serviceName": "orcl", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } Расширенный тип подключения { "version": "2.0.0", "type": "connection", "name": "oracle_db_non_ssl_advanced ", "description": " Sample non-SSL Oracle Database connection created with the advanced connection string format using Connections API", "content": { "connectionParams": { "connectionString": "(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=example.com)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)))", "username": "admin", "password": "<password>", "connectionType": "oracle-database", "remoteData": false, "systemConnection": false } } } |
Oracle Database с SSL |
multi-part/form-data |
cwallet.sso (client credentials file) Базовый тип подключения cert: <cwallet.sso file location> connectionParams: { "version": "2.0.0", "type": "connection", "name": "oracle_db_ssl", "description": "Sample Oracle Database connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-database", "host": "example.com", "port": "2484", "serviceName": "ORCLPDB1", "username": "admin", "password": "<password>", "systemConnection": false, "remoteData": false } } } |
Oracle Autonomous Data Warehouse — без накопителя (TLS) |
application/json |
Базовый тип подключения { "version": "2.0.0", "type": "connection", "name": "oracle_adw_walletless_basic", "description": "Sample Oracle ADW connection without a wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521) (host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))", "username": "admin", "password": "<password>", "systemConnection": false, "remoteData": false, "sslType": "ServerSideSSL" } } } |
Oracle Autonomous Data Warehouse — с накопителем (взаимная аутентификация TLS) |
multipart/form-data |
cwallet.sso (client credentials file) Базовый тип подключения cert: <cwallet.sso file location> connectionParams: { "version": "2.0.0", "type": "connection", "name": "oracle_adw_with_wallet", "description": "Sample Oracle ADW connection with wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))", "username": "admin", "password": "<password>", "remoteData": "false", "systemConnection": false, "sslType": "ClientSideSSL" } } } |
PostgreSQL (Не SSL) |
application/json |
Базовый тип подключения { "version":"2.0.0", "type": "connection", "name": "postgres_non_SSL", "description": "Sample PostgreSQL connection created using Connections API", "content": { "connectionParams": { "connectionType": "postgresql-database", "host": "example.com", "port": "5432", "serviceName": "postgres", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
PostgreSQL с SSL |
application/json |
Базовый тип подключения { "version":"2.0.0", "type": "connection", "name": "postgres_SSL_Conn", "description": "Sample PostgreSQL connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "postgresql-database", "host": "example.com", "port": "5432", "serviceName": "postgres", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
SQL Server (Не SSL) |
application/json |
Базовый тип подключения { "version":"2.0.0", "type": "connection", "name": "SqlServer_non_ssl", "description": "Sample non-SSL SQL Server connection created using Connections API", "content": { "connectionParams": { "connectionType": "sqlserver-database", "host": "example.com", "port": "1400", "serviceName": "sqlserver1", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
SQL Server с SSL | application/json |
Базовый тип подключения { "version":"2.0.0", "type": "connection", "name": "SqlServer_ssl", "description": "Sample SQL Server connection with SSL created using the Connections API", "content": { "connectionParams": { "connectionType": "sqlserver-database", "host": "example.com", "port": "60190", "serviceName": "sqlserver1", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
MySQL (Не SSL) |
application/json |
Базовый тип подключения { "version":"2.0.0", "type": "connection", "name": "MySql_no_SSL", "description": "Sample MySQL connection created using the Connections API", "content": { "connectionParams": { "connectionType": "mysql-database", "host": "example.com", "port": "3307", "serviceName": "mysql1", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
MySQL с SSL | application/json |
Базовый тип подключения { "version":"2.0.0", "type": "connection", "name": "MySql_ssl", "description": "Sample MySQL connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "mysql-database", "host": "example.com", "port": "3306", "serviceName": "mysql1", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
Oracle Essbase |
application/json |
Базовый тип подключения { "version":"2.0.0", "type": "connection", "name": "Oracle_Essbase", "description": "Sample Oracle Essbase connection created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-essbase", "dsn":"example.com", "username":"admin", "password":"<password>", "remoteData": false, "systemConnection": false, "authentication":"current"/"private"/"sso" } } } |