Pode criar, atualizar, retirar e partilhar ligações a origens de dados. Enquanto utilizador do Oracle Analytics com acesso de Autor de Conteúdo do DV, pode efetuar estas ações.
Tópicos:
Pode criar uma ligação que permita analisar dados nessa origem de dados.
Pode atualizar os detalhes de ligação à origem dos dados.
Se estiver a editar uma ligação de SSL ao Oracle AI Database e precisar de utilizar um novo ficheiro cwallet.sso, no campo Wallet do Cliente, clique em Selecionar para navegar para o ficheiro cwallet.sso. Peça ao seu administrador a localização do ficheiro cwallet.sso.
Pode retirar uma ligação à origem de dados a partir do Oracle Analytics Cloud. Por exemplo, deve apagar uma ligação à base de dados e criar uma nova quando a senha da base de dados é alterada.
Se a ligação contiver quaisquer conjuntos de dados, deve apagar os conjuntos de dados para poder apagar a ligação.
Pode atribuir permissões de acesso às ligações das origens de dados que criar ou administrar.
Quando especifica os detalhes da ligação utilizando a caixa de diálogo Criar Ligação ou Inspecionar, alguns tipos de bases de dados têm opções de configuração extra.
Opções Gerais
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)))
Ativar Replicação em Grupo - Se estiver a carregar um conjunto de dados para um livro, esta opção deve estar desativada e pode ignorá-la. Esta opção está reservada para analistas de dados e utilizadores avançados para a replicação de dados de uma base de dados para outra base de dados.
Localização: A pasta do catálogo onde os detalhes da ligação estão armazenados. Utilize a opção Percorrer para alterar a pasta por omissão (ou seja, Pastas Privadas). Se pretender que os outros utilizadores possam utilizar a ligação, grave a ligação na área Pastas Partilhadas.
Opções de Autenticação
Ligação ao sistema
Selecione a Ligação ao sistema se pretender utilizar estes detalhes da ligação no Modelador Semântico ou no Model Administration Tool.
Nota: Se não clicar em Ligação ao sistema quando criar inicialmente a ligação e, posteriormente, pretender que os modeladores de dados utilizem os detalhes da ligação, terá de criar uma nova ligação e selecionar Ligação ao sistema. Por outras palavras, não pode editar a ligação posteriormente e selecionar esta opção.
Conheça os requisitos de ligação da sua base de dados antes de criar a ligação à base de dados.
O número máximo de tabelas de bases de dados apresentadas no Oracle Analytics é 10.000. Caso necessite de tabelas adicionais, a Oracle recomenda que solicite ao seu administrador da base de dados que crie um nome de utilizador da base de dados com acesso a objetos específicos que pretenda analisar e especifique as credenciais desse utilizador ao criar a ligação à base de dados.
Se estiver a ligar a uma base de dados Oracle, Oracle Autonomous AI Lakehouse, Oracle Autonomous AI Transaction Processing, Snowflake, SQL Server ou My SQL, pode alterar o identificador delimitado por aspas por omissão para poder ler dados com caracteres superiores, inferiores ou mistos nos nomes de tabelas ou colunas.
select "EfG_Field" from "AbCd"; em vez de emitir select EfG_Field from AbCd; (que falharia).Pode utilizar as API REST do Oracle Analytics Cloud para gerir de forma programática ligações a uma variedade de origens de dados. Por exemplo, pode pretender criar um script que cria (ou modifica) o mesmo conjunto de ligações nos seus ambientes de teste e de produção do Oracle Analytics Cloud.
Pode criar, atualizar e apagar ligações para um intervalo de origens de dados utilizando as API REST. Este tópico lista os tipos de ligações de origem de dados que pode gerir com as API REST.
Nota:
REST API for Oracle Analytics Cloud fornece informações detalhadas sobre cada API REST. Consulte Endpoints REST de Ligação.Origens de Dados Suportadas
Parâmetros de Ligação
Os parâmetros de ligação obrigatórios para cada origem de dados são diferentes. Se pretender utilizar a API REST para criar ou atualizar uma ligação, deve conhecer o formato do payload JSON obrigatório para a sua origem de dados. Consulte Payloads JSON de Exemplo para Origens de Dados.
Seguem-se as tarefas comuns para começar a utilizar as API REST do Oracle Analytics Cloud para gerir de forma programática as ligações. Se estiver a utilizar as API REST pela primeira vez, siga estas tarefas como guia.
| Tarefa | Descrição | Documentação da API REST |
|---|---|---|
| Noções básicas de pré-requisitos |
Noções básicas e conclusão de várias tarefas de pré-requisitos. Deve ter permissões para criar livros e associar a dados no Oracle Analytics Cloud para gerir ligações de dados utilizando as API REST (Autor de Conteúdo do DV). |
Pré-requisitos |
| Noções básicas sobre a autenticação de token OAuth 2.0 | A autenticação e autorização no Oracle Analytics Cloud é gerida pelo Oracle Identity Cloud Service. Para aceder às API REST do Oracle Analytics Cloud, necessita de um token de acesso OAuth 2.0 para utilizar para autorização. | Autenticação de Token OAuth 2.0 |
| Noções sobre origens de dados suportadas | Leia o tópico que descreve os tipos de ligações de dados que pode gerir com as API REST. | Origens de Dados Suportadas |
| Determinar formatos de payload JSON | Leia o tópico que descreve o formato do payload JSON para a sua origem de dados e obtenha os parâmetros de ligação obrigatórios. | Payloads JSON de Exemplo para Origens de Dados |
| Criar uma ligação | Crie uma ligação de dados para utilizar nos livros, relatórios e dashboards. | Criar uma ligação |
| Atualizar uma ligação | Atualize uma ou mais propriedades de uma ligação de dados existente. | Atualizar uma ligação |
| Apagar uma ligação | Apague uma ligação de dados. | Apagar uma ligação |
Utilize estes exemplos para o ajudar a gerir ligações de origens de dados com pedidos de API REST utilizando cURL.
Formato cURL de Exemplo
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>"
<token> - Token de portador OAuth 2.0 obrigatório para autenticar chamadas para as API REST do Oracle Analytics Cloud. Consulte Autenticação de Token OAuth 2.0 .
<hostname> - Host onde o Oracle Analytics Cloud está em execução.
<data source connection payload> - Informações de ligação específica da origem de dados. Consulte Payloads JSON de Exemplo para Origens de Dados.
<security wallet file> - Armazena informações relacionadas com SSL como as credenciais de autenticação e assinatura, chaves privadas, certificados e certificado fidedigno. Obrigatório para alguns tipos de ligação, como o Oracle AI Database com SSL e o Oracle Autonomous AI Lakehouse (Mutual TLS).
Exemplos
Os seguintes exemplos mostram como criar uma ligação ao Oracle Autonomous AI Lakehouse (ALK).
cwallet.sso (Mutual TLS)Nota:
Os payloads JSON nos presentes exemplos são específicos do Oracle ALK. O formato do payload JSON é diferente para outras origens de dados. Consulte Payloads JSON de Exemplo para Origens de Dados.Exemplo 1 - Criar uma ligação sem wallet (TLS) ao Oracle Autonomous AI Lakehouse
oracle_ALK_walletless. O corpo do pedido inclui JSON simples application/json.
curl
--header "Autorização: Titular <token>"
--header "Tipo de Conteúdo: aplicação/json"
--pedir POST https://example.com/api/20210901/catalog/connections
--dados "{
"versão": "2.0.0",
"tipo": "ligação",
"nome": "oracle_ALK_walletless",
"descrição": "Exemplo de ligação ALK do Oracle sem um wallet criado utilizando a API de Ligações",
"conteúdo": {
"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_ALKwalletless_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))",
"nome de utilizador": "ADMIN",
"senha": "<<password>>",
"systemConnection": falso,
"remoteData": falso,
"sslType": "ServerSideSSL"
}
}
}"Corpo da Resposta
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Anote a connectionId codificada em Base64 no corpo da resposta. Mais tarde, pode utilizar este valor para atualizar ou apagar a ligação.
Exemplo 2 - Criar uma ligação ao Oracle ALK que utiliza um ficheiro de wallet (Mutual TLS)
oracle_ALK_with_wallet. O corpo da pedido inclui multipart/form-data, isto é, requer o ficheiro de wallet do Oracle ALK (cwallet.sso) e os parâmetros de ligação do Oracle ALK.
curl
--header "Authorization: Bearer <token>"
-–request POST https://<hostname>/api/20210901/catalog/connections
--form "cert=@"/Users/scott/Downloads/Wallet_ALK/cwallet.sso""
--form "connectionParams= "{
"versão": "2.0.0",
"tipo": "ligação",
"nome": "oracle_ALK_with_wallet",
"descrição": "Exemplo de ligação do Oracle ALK a um wallet criado através da API de Ligações",
"conteúdo": {
"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_walletALK_high.ALKc.oraclecloud.com/))(security=(ssl_server_dn_match=yes)))",
"nome de utilizador": "ADMIN",
"senha": "<<password>>",
"remoteData": "falso",
"systemConnection": falso,
"sslType": "ClientSideSSL"
}
}
}"Corpo da Resposta
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Anote a connectionId codificada em Base64 no corpo da resposta. Mais tarde, pode utilizar este valor para atualizar ou apagar a ligação.
Estão disponíveis exemplos adicionais em REST API for Oracle Analytics Cloud. Consulte Criar uma ligação, Atualizar uma ligação e Apagar uma ligação.
Para ligar a uma origem de dados, deve fornecer parâmetros de ligação. Quando utiliza a API REST de Ligações, especifique parâmetros de ligação num determinado formato de payload JSON. Utilize esta tabela para determinar o payload JSON para a origem de dados à qual pretende ligar.
| Origem de Dados | Tipo de Pedido | Payload de Entrada de Dados |
|---|---|---|
|
Oracle AI Database (Não SSL) |
application/json |
Tipo de Ligação Básica {
"version": "2.0.0",
"type": "connection",
"name": "oracle_db_non_ssl_basic",
"description": "Sample non-SSL Oracle AI 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
}
}
}
Tipo de Ligação Avançada {
"version": "2.0.0",
"type": "connection",
"name": "oracle_db_non_ssl_advanced ",
"description": " Sample non-SSL Oracle AI 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 AI Database com SSL |
multi-part/form-data |
cwallet.sso (client credentials file) Tipo de Ligação Básica cert: <cwallet.sso file location>
connectionParams: {
"version": "2.0.0",
"type": "connection",
"name": "oracle_db_ssl",
"description": "Sample Oracle AI 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 AI Lakehouse - Sem Wallet (TLS) |
application/json |
Tipo de Ligação Básica {
"version": "2.0.0",
"type": "connection",
"name": "oracle_ALK_walletless_basic",
"description": "Sample Oracle ALK 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 AI Lakehouse - Wallet (Mutual TLS) |
multipart/form-data |
cwallet.sso (client credentials file) Tipo de Ligação Básica cert: <cwallet.sso file location>
connectionParams: {
"version": "2.0.0",
"type": "connection",
"name": "oracle_ALK_with_wallet",
"description": "Sample Oracle ALK 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 (Não SSL) |
application/json |
Tipo de Ligação Básica {
"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 com SSL |
application/json |
Tipo de Ligação Básica {
"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 (Não SSL) |
application/json |
Tipo de Ligação Básica {
"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 com SSL | application/json |
Tipo de Ligação Básica {
"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 (Não SSL) |
application/json |
Tipo de Ligação Básica {
"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 com SSL | application/json |
Tipo de Ligação Básica {
"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 |
Tipo de Ligação Básica {
"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"
}
}
} |