As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Crie conexões definidas pelo usuário AWS Glue
<a name="sagemaker-sql-extension-datasources-glue-connection-user-defined"></a>

**nota**  
Todas as AWS Glue conexões criadas pelos usuários por meio da interface de usuário da extensão SQL são automaticamente marcadas com o seguinte:  
`UserProfile: user-profile-name`
`AppType: "JL"`
Essas tags aplicadas às AWS Glue conexões criadas por meio da interface de usuário da extensão SQL têm dois propósitos. A `"UserProfile": user-profile-name` tag permite a identificação do perfil de usuário específico que criou a AWS Glue conexão, fornecendo visibilidade ao usuário responsável pela conexão. A `"AppType": "JL"` tag categoriza a proveniência da conexão, associando-a ao aplicativo. JupyterLab Isso permite que essas conexões sejam diferenciadas daquelas que podem ter sido criadas por outros meios, como a AWS CLI. 

## Pré-requisitos
<a name="sagemaker-sql-extension-datasources-glue-connection-user-defined-prerequisites"></a>

Antes de criar uma AWS Glue conexão usando a interface de usuário da extensão SQL, verifique se você concluiu as seguintes tarefas: 
+ Faça com que seu administrador:
  + Habilite a comunicação de rede entre o domínio do Studio e as fontes de dados às quais você deseja se conectar. Para saber quais são os requisitos de rede, consulte [Configurar o acesso à rede entre o Studio e as fontes de dados (para administradores)](sagemaker-sql-extension-networking.md).
  + As permissões necessárias do IAM devem estar configuradas para gerenciar conexões do AWS Glue e o acesso ao Secrets Manager. Para saber quais são as permissões necessárias, consulte [Configurar as permissões do IAM para acessar as fontes de dados (para administradores)](sagemaker-sql-extension-datasources-connection-permissions.md).
**nota**  
Os administradores podem restringir o acesso do usuário somente às conexões que foram criadas por um usuário dentro do JupyterLab aplicativo. Isso pode ser feito configurando o [controle de acesso baseado em tags](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-sql-extension-datasources-connection-permissions.html#user-defined-connections-permissions) com escopo reduzido ao perfil de usuário.
+ Verifique as propriedades e instruções da conexão para criar um segredo para sua fonte de dados em [Criar segredos no Secrets Manager para credenciais de acesso de banco de dados](sagemaker-sql-extension-glue-connection-secrets.md).

## Fluxo de trabalho do usuário
<a name="sagemaker-sql-extension-datasources-glue-connection-user-defined-steps"></a>

As seguintes etapas apresentam o fluxo de trabalho do usuário ao criar conexões de usuário:

1. **Selecione o tipo de fonte de dados**: ao escolher o ícone de *adicionar nova conexão*, um formulário é aberto, solicitando que o usuário selecione o tipo de fonte de dados à qual deseja se conectar, como Amazon Redshift, Athena ou Snowflake.

1. **Forneça as propriedades da conexão**: com base na fonte de dados selecionada, as propriedades pertinentes da conexão são carregadas dinamicamente. O formulário indica quais campos são obrigatórios ou opcionais para a fonte de dados escolhida. Para saber quais propriedades estão disponíveis para sua fonte de dados, consulte [Parâmetros de conexão](sagemaker-sql-extension-connection-properties.md).

1. **Selecione seu AWS Secrets Manager ARN**: Para fontes de dados do Amazon Redshift e do Snowflake, o usuário é solicitado a selecionar o ARN do Secrets AWS Manager que armazena informações confidenciais, como nome de usuário e senha. Para saber como criar um segredo para sua fonte de dados, consulte[Criar segredos no Secrets Manager para credenciais de acesso de banco de dados](sagemaker-sql-extension-glue-connection-secrets.md).

1. **Salve os detalhes da conexão**: ao clicar em **Criar**, as propriedades da conexão fornecidas são salvas como uma conexão do AWS Glue . 

1. **Teste sua conexão**: se a conexão tiver êxito, os bancos de dados e tabelas correspondentes ficarão visíveis no explorador. Se a conexão falhar, uma mensagem de erro será exibida, solicitando que o usuário analise e corrija os detalhes da conexão.

1. **Familiarize-se com os recursos da extensão de SQL**: para saber quais são os recursos da extensão, consulte [Atributos e uso da extensão SQL](sagemaker-sql-extension-features.md).

1. **(Opcional) Atualize ou exclua as conexões criadas pelo usuário**: desde que o usuário tenha recebido as permissões necessárias, ele poderá atualizar ou excluir as conexões que criou. Para saber mais sobre as permissões necessárias, consulte [Permissões do IAM necessárias para conexões definidas por usuários](sagemaker-sql-extension-datasources-connection-permissions.md#user-defined-connections-permissions).