# Conectar ao SAP HANA no AWS Glue Studio
O AWS Glue oferece suporte integrado ao SAP HANA. O AWS Glue Studio fornece uma interface visual para conectar ao SAP HANA, criar trabalhos de integração de dados e executá-los no runtime Spark do AWS Glue Studio sem servidor.
O AWS Glue Studio cria uma conexão unificada para o SAP HANA. Para obter mais informações, consulte [Considerações](using-connectors-unified-connections.md#using-connectors-unified-connections-considerations).
**Topics**
+ [Criar uma conexão SAP HANA](creating-saphana-connection.md)
+ [Criar um nó de origem do SAP HANA](creating-saphana-source-node.md)
+ [Criar um nó de destino do SAP HANA](creating-saphana-target-node.md)
+ [Opções avançadas](#creating-saphana-connection-advanced-options)
# Criar uma conexão SAP HANA
Para se conectar ao SAP HANA via AWS Glue, será necessário criar e armazenar suas credenciais do SAP HANA em um segredo do AWS Secrets Manager e, em seguida, associar esse segredo a uma conexão ao AWS Glue do SAP HANA. Você precisará configurar a conectividade de rede entre seu serviço SAP HANA e o AWS Glue.
**Pré-requisitos**:
+ Se o seu serviço SAP HANA estiver em uma Amazon VPC, configure a Amazon VPC para permitir que seu trabalho do AWS Glue se comunique com o serviço SAP HANA sem que o tráfego passe pela Internet pública.
Na Amazon VPC, identifique ou crie uma **VPC**, uma **Sub-rede** e um **Grupo de segurança** que o AWS Glue usará durante a execução do trabalho. Além disso, você precisa garantir que a Amazon VPC esteja configurada para permitir o tráfego de rede entre seu endpoint SAP HANA e esse local. Seu trabalho precisará estabelecer uma conexão TCP com a porta JDBC do SAP HANA. Para obter mais informações sobre as portas do SAP HANA, consulte a [Documentação do SAP HANA](https://help.sap.com/docs/HANA_SMART_DATA_INTEGRATION/7952ef28a6914997abc01745fef1b607/88e2e8bded9e4041ad3ad87dc46c7b55.html?locale=en-US). Com base no layout da rede, isso pode exigir alterações em regras do grupo de segurança, ACLs de rede, gateways de NAT e conexões de emparelhamento.
**Para configurar uma conexão com o SAP HANA:**
1. No AWS Secrets Manager, crie um segredo usando suas credenciais do SAP HANA. Para criar um segredo no Secrets Manager, siga o tutorial disponível em [Criar uma AWS Secrets Manager segredo ](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html) na documentação do AWS Secrets Manager. Depois de criar o segredo, guarde o nome secreto, *SecretName*, para a próxima etapa.
+ Ao selecionar **Pares chave/valor**, crie um par para a chave `username/USERNAME` com o valor *saphanaUsername*.
+ Ao selecionar **Pares chave/valor**, crie um par para a chave `password/PASSWORD` com o valor *saphanaPassword*.
1. No console do AWS Glue, crie uma conexão seguindo as etapas em [Adicionar uma conexão do AWS Glue](console-connections.md). Depois de criar a conexão, guarde o nome da conexão, *connectionName*, para uso futuro em AWS Glue.
+ Ao selecionar um **Tipo de conexão**, selecione SAP HANA.
+ Ao fornecer o **URL do SAP HANA**, forneça o URL da sua instância.
Os URLs JDBC do SAP HANA estão no formato `jdbc:sap://saphanaHostname:saphanaPort/?databaseName=saphanaDBname,ParameterName=ParameterValue`
O AWS Glue requer os seguintes parâmetros de URL do JDBC:
+ `databaseName`: um banco de dados padrão no SAP HANA ao qual se conectar.
+ Ao selecionar um **Segredo da AWS**, forneça o *secretName*.
Depois de criar uma conexão AWS Glue SAP HANA, siga estas etapas antes de executar seu trabalho do AWS Glue:
+ Conceda ao perfil do IAM associada ao seu trabalho do AWS Glue permissão para ler *secretName*.
# Criar um nó de origem do SAP HANA
## Pré-requisitos necessários
+ Uma conexão AWS Glue SAP HANA configurada com um segredo do AWS Secrets Manager, conforme descrito na seção anterior, [Criar uma conexão SAP HANA](creating-saphana-connection.md).
+ Permissões apropriadas em seu trabalho para ler o segredo usado pela conexão.
+ Uma tabela do SAP HANA da qual você gostaria de ler, *tableName*, ou consultar *targetQuery*.
Uma tabela pode ser especificada com um nome de tabela e um nome de esquema do SAP HANA, no formulário `schemaName.tableName`. O nome do esquema e o separador "." não serão necessários se a tabela estiver no esquema padrão, "público". Chame isso de *tableIdentifier*. Observe que o banco de dados é fornecido como um parâmetro de URL do JDBC em `connectionName`.
## Adicionar uma fonte de dados do SAP HANA
**Para adicionar um nó de **Fonte de dados – SAP HANA**:**
1. Escolha a conexão para sua fonte de dados do SAP HANA. Como você o criou, ele deve estar disponível no menu suspenso. Se precisar criar uma conexão, escolha **Criar conexão com o SAP HANA**. Para mais informações, consulte a seção [Criar uma conexão SAP HANA](creating-saphana-connection.md) anterior.
Depois de escolher uma conexão, você pode visualizar as propriedades da conexão clicando em **Exibir propriedades**.
1. Escolha uma opção de **Fonte do SAP HANA**:
+ **Escolher uma única tabela**: acesse todos os dados de uma única tabela.
+ **Inserir consulta personalizada**: acesse um conjunto de dados de várias tabelas com base em sua consulta personalizada.
1. Se você escolheu uma única tabela, insira *tableName*.
Se você escolheu **Inserir consulta personalizada**, insira uma consulta SQL SELECT.
1. Em **Propriedades personalizadas do SAP HANA**, insira parâmetros e valores conforme necessário.
# Criar um nó de destino do SAP HANA
## Pré-requisitos necessários
+ Uma conexão AWS Glue SAP HANA configurada com um segredo do AWS Secrets Manager, conforme descrito na seção anterior, [Criar uma conexão SAP HANA](creating-saphana-connection.md).
+ Permissões apropriadas em seu trabalho para ler o segredo usado pela conexão.
+ Uma tabela do SAP HANA na qual você gostaria de escrever, *tableName*.
Uma tabela pode ser especificada com um nome de tabela e um nome de esquema do SAP HANA, no formulário `schemaName.tableName`. O nome do esquema e o separador "." não serão necessários se a tabela estiver no esquema padrão, "público". Chame isso de *tableIdentifier*. Observe que o banco de dados é fornecido como um parâmetro de URL do JDBC em `connectionName`.
## Adicionar um destino de dados do SAP HANA
**Para adicionar um nó de **Destino de dados – SAP HANA**:**
1. Escolha a conexão para sua fonte de dados do SAP HANA. Como você o criou, ele deve estar disponível no menu suspenso. Se precisar criar uma conexão, escolha **Criar conexão com o SAP HANA**. Para mais informações, consulte a seção [Criar uma conexão SAP HANA](creating-saphana-connection.md) anterior.
Depois de escolher uma conexão, você pode visualizar as propriedades da conexão clicando em **Exibir propriedades**.
1. Configure o **nome da tabela** fornecendo o *tableName*.
1. Em **Propriedades personalizadas do Teradata**, insira parâmetros e valores conforme necessário.
## Opções avançadas
É possível fornecer opções avançadas ao criar um nó do SAP HANA. Essas opções são as mesmas disponíveis ao programar AWS Glue para scripts do Spark.
Consulte [Conexões do SAP HANA](aws-glue-programming-etl-connect-saphana-home.md).