Configuração de fontes remotas

Objective

After completing this lesson, you will be able to crie uma fonte remota usando a interface do usuário ou SQL.

Configuração de fonte remota com a interface gráfica do usuário

Quando os pré-requisitos técnicos e relacionados à segurança estiverem em vigor, você estará pronto para criar uma fonte remota. Existem duas formas principais de fazer isso:

No catálogo do Explorador de banco de dados SAP HANA, com a interface gráfica de usuário
Em qualquer console SQL conectado ao seu banco de dados local/de destino, com uma instrução SQL

Vamos discutir primeiro o processo gráfico de criação baseada na interface do usuário.

Para criar uma fonte remota com a interface gráfica do usuário

Navegue até a seção Catálogo para fontes remotas.
Clique com o botão direito do mouse em Fontes remotas e selecione Adicionar fonte remota.
Defina o nome da fonte remota.
Selecione o Adaptador relevante.
Para fontes remotas SDI, indique uma localização do adaptador ("Unidade gerencial de origem").
Preencha a propriedade de fonte remota.
Selecione Criar.

Inicie este vídeo para saber como criar uma fonte remota de acesso a dados inteligentes com o editor baseado em formulário no Explorador de banco de dados SAP HANA.

A criação de fontes remotas para cenários de integração de dados inteligentes com a interface gráfica de usuário é muito semelhante ao que acabamos de discutir. Uma diferença importante é que, como os adaptadores não estão sendo executados no servidor de índice da instância do banco de dados SAP HANA, é necessário especificar onde os adaptadores estão localizados. Aqui está um lembrete:

Os adaptadores OData são executados no servidor de provisionamento de dados (dentro do banco de dados).
O dpserver de localização é atribuído automaticamente e não pode ser modificado.
Todos os outros adaptadores de integração de dados inteligentes são executados em um agente de provisionamento de dados
Você indica um agente de provisionamento de dados, ou um grupo de agentes de provisionamento de dados, caso vários agentes façam parte de um grupo de agentes de alta disponibilidade.
Nota
A configuração de agentes é determinada pela equipe de administração do sistema. O que você só precisa deles são as informações sobre qual agente ou grupo de agentes deve ser utilizado em um cenário específico.

Inicie este vídeo para saber como criar uma fonte remota de integração de dados inteligentes com o editor baseado em formulário no Explorador de banco de dados SAP HANA.

Verificar uma fonte remota

Quando você cria uma fonte remota no Explorador de banco de dados SAP HANA com um formulário, duas verificações automáticas sucessivas são executadas.

Consistência de fonte remota – Bloqueio
A definição de fonte remota deve estar "sintaticamente" correta com todos os parâmetros necessários preenchidos.
A verificação pode falhar, por exemplo, se você tiver esquecido o nome do servidor ou não tiver fornecido o nome do usuário e a senha para um usuário técnico.
Nesse caso, a fonte remota não pode ser criada. Você deve modificar a definição da fonte remota e tentar salvá-la novamente.
Nota
No formulário de definição de fonte remota, todos os parâmetros obrigatórios são identificados com um asterisco vermelho.
Conectividade de fonte remota – sem bloqueio
Esta verificação de segundo nível, acionada automaticamente no formulário do database explorer do SAP HANA, verifica se a definição da fonte remota permite que o SAP HANA se conecte ao sistema remoto e autentique o usuário remoto.
Se esta verificação não for aprovada, você só recebe uma advertência que NÃO impede a criação da fonte remota.
A verificação pode falhar, por exemplo, devido a um erro no nome do servidor ou na configuração do SAP Cloud Connector (se aplicável), ou simplesmente porque o servidor remoto não está disponível atualmente. Outro motivo pode ser porque a fonte remota está definida com credenciais secundárias, mas atualmente não existe nenhuma credencial para seu usuário.
Nesse caso, só é emitido um aviso. Você pode modificar a definição da fonte remota imediatamente (por exemplo, se identificar um erro óbvio), mas também pode salvar a definição da fonte remota como está e modificá-la posteriormente.

Configuração de fonte remota com SQL

Como alternativa ao uso da interface gráfica do usuário do Explorador de banco de dados SAP HANA para criar fontes remotas, você pode executar instruções SQL. Um dos principais benefícios é que você pode criar várias fontes remotas em lote muito rapidamente.

A instrução SQL é estruturada da seguinte forma:

Code Snippet

123456
CREATE REMOTE SOURCE "<remote_source_name>"
ADAPTER "<adapter_name>"
AT LOCATION <agent_or_agent_group_name>
CONFIGURATION '<configuration_string>' 
WITH CREDENTIAL TYPE '<credential_type>'
                USING '<credential_definition_string>';

Vejamos um exemplo simples em que definiremos uma fonte remota de acesso a dados inteligentes apontando para um sistema de origem SAP HANA on-premise.

Code Snippet

1234
CREATE REMOTE SOURCE "RS1"
ADAPTER "hanaodbc" 
CONFIGURATION 'ServerNode=hana_cloud_src1.mycompany.com:30115' 
WITH CREDENTIAL TYPE 'PASSWORD' USING 'user=myuser;password=MyPassword';

Nota

Considere que, uma vez que é uma fonte remota SAP HANA, acesso aos dados inteligente, não existe nenhuma cláusula AT LOCATION.

Para fontes de dados SAP HANA, acesso aos dados inteligente, existem duas variantes para definir a cadeia de configuração. O acima é mais compacto. A versão mais longa abaixo passa a configuração como XML. Ambos alcançam o mesmo resultado.

Code Snippet

1234567891011
CREATE REMOTE SOURCE "RS1"
ADAPTER "hanaodbc"
CONFIGURATION
'<?xml version="1.0" encoding="UTF-8"?>
<ConnectionProperties name="connectionproperties">
  <PropertyEntry name="adapterversion">1.0</PropertyEntry>
  <PropertyEntry name="connectionmode">Adapter Properties</PropertyEntry>
  <PropertyEntry name="server">hana_cloud_src1.mycompany.com</PropertyEntry>
  <PropertyEntry name="port">30015</PropertyEntry>
</ConnectionProperties>'
WITH CREDENTIAL TYPE 'PASSWORD' USING 'user=myuser;password=MyPassword';

Nota

Esta forma mais longa é opcional para a fonte de acesso a dados inteligentes SAP HANA. Isso é apresentado aqui porque é isso que você obtém quando seleciona GERAR DECLARAÇÃO DE CRIAÇÃO a partir de uma fonte remota existente no catálogo Explorador de banco de dados SAP HANA.

Inicie este vídeo para saber como criar uma fonte remota com uma instrução SQL.

Correspondendo o nome do adaptador (SQL) com o nome de exibição do adaptador (interface gráfica do usuário)

Ao trabalhar com SQL e com o Database Explorer do SAP HANA para criar fontes remotas, você pode encontrar na tabela do sistema "SYS"."ADAPTERS" a lista de adaptadores atualmente em execução no banco de dados SAP HANA. Isso permite que você compare o nome de um adaptador usado em uma instrução SQL CREATE REMOTE SOURCE com o nome de exibição exibido no Explorador de banco de dados SAP HANA quando você cria ou edita uma definição de fonte remota.

A tabela pode ser consultada da seguinte forma:

Code Snippet

1
SELECT * FROM "SYS"."ADAPTERS";

O resultado mostra todos os adaptadores de sistema (SDA), além de todos os adaptadores atualmente registrados em qualquer um dos agentes de provisionamento de dados conectados ao banco de dados SAP HANA local.

Este slide mostra como listar os adaptadores disponíveis

Verificar uma fonte remota

Quando você cria uma fonte remota com SQL, estão disponíveis dois níveis de verificação.

Consistência de fonte remota – Bloqueio
Esta verificação é efetuada como parte da instrução SQL CREATE REMOTE SOURCE.
A definição de fonte remota deve estar "sintaticamente" correta, com todos os parâmetros obrigatórios preenchidos.
A verificação pode falhar, por exemplo, se você esqueceu o nome do servidor ou não forneceu um nome de agente válido na cláusula AT LOCATION (quando aplicável).
Nesse caso, a instrução SQL falha e a fonte remota não pode ser criada. Você deve modificar a instrução SQL e executá-la novamente.
Conectividade de fonte remota – sem bloqueio
Esta verificação é opcional, não faz parte da instrução CREATE REMOTE SOURCE.
Você pode executar uma instrução SQL adicional para verificar se a definição da fonte remota permite que o SAP HANA se conecte ao sistema remoto e autentique o usuário remoto.
Code Snippet
```
1
CALL CHECK_REMOTE_SOURCE('<remote_source_name>');
```
A execução deste procedimento é bem sucedida (verificação aprovada) ou, se falhar, você obtém alguns detalhes sobre a causa principal no console SQL.
Isso pode ser um erro no nome do servidor ou na configuração do SAP Cloud Connector, se aplicável, ou simplesmente o fato de que o servidor remoto não está atualmente disponível. Em outros contextos, isso pode ocorrer porque a fonte remota está definida com credenciais secundárias, mas não existe nenhuma credencial desse tipo para seu usuário.

Next lesson