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á.

# Práticas recomendas e solução de problemas
<a name="sql-server-best-practices"></a>

Melhores práticas e problemas comuns e suas soluções durante o processo de modernização.

## Registros de aplicativos do ECS
<a name="sql-server-ecs-application-logs"></a>

### CloudWatch troncos
<a name="sql-server-cloudwatch-logs"></a>
+ Todos os registros de contêineres do ECS são enviados automaticamente para CloudWatch Logs
+ Acesse os registros no CloudWatch console em Grupos de registros
+ Formato de nomenclatura do grupo de registros:/aws/ecs/{application-name}
+ Cada instância de contêiner cria um novo fluxo de log dentro do grupo.

### Visualizar logs
<a name="sql-server-viewing-logs"></a>

**Por meio AWS do console:**
+ Navegue até CloudWatch > Grupos de registros
+ Selecione o grupo de registros do seu aplicativo
+ Escolha o fluxo de registros relevante para visualizar os registros do contêiner

**Usando a AWS CLI:**

```
aws logs get-log-events --log-group-name /aws/ecs/your-app-name --log-stream-name your-stream-name
```

### Localizações comuns de registros
<a name="sql-server-common-log-locations"></a>
+ Registros do aplicativo: CloudWatch registros
+ Eventos do serviço ECS: Console do ECS > Cluster > Serviço > guia Eventos
+ Contêiner health/status: Console do ECS > Cluster > Serviço > guia Tarefas

## Gerenciamento de conexões de banco de dados
<a name="sql-server-database-connection-management"></a>

Os aplicativos usam variáveis de ambiente para configurações de conexão do banco de dados

Se você tiver problemas de conectividade:
+ Verifique as configurações de conexão atuais em suas variáveis de ambiente
+ Atualize as variáveis de ambiente para modificar as cadeias de conexão do banco de dados conforme necessário
+ Alterações na cadeia de conexão podem ser feitas por meio de atualizações de variáveis de ambiente sem a reimplantação do aplicativo

## Problemas de conexão de banco de dados
<a name="database-connection-issues"></a>

**Problema:** Não é possível conectar o AWS Transform ao SQL Server

Soluções:
+ Verifique a conectividade de rede entre o AWS Transform e o SQL Server
+ Verifique as regras do grupo de segurança para acesso adequado à porta (1433)
+ Confirme as credenciais do banco de dados no Secrets Manager
+ Teste as permissões do banco de dados com o usuário criado
+ Verifique se o SQL Server está configurado para autenticação em modo misto
+ Verifique se o segredo tem as tags necessárias (Projeto: atx-db-modernization, proprietário: database-connector)

## Problemas de firewall e grupos de segurança
<a name="firewall-security-group-issues"></a>

**Problema:** tempo limite de conexão ou erros de “não é possível acessar o banco de dados”

**Causa raiz:** grupos de segurança ou ACLs de rede bloqueando o tráfego

Soluções:

1. Verifique a configuração do grupo de segurança:
   + Confirme se seu grupo de segurança do SQL Server tem uma regra de entrada que permite a porta 1433 do grupo de segurança DMS Schema Conversion
   + Verifique se a origem é o ID do grupo de segurança (por exemplo, sg-0123456789abcdef0), não um endereço IP
   + Verifique se o grupo de segurança DMS Schema Conversion está especificado corretamente no Perfil da Instância
   + Certifique-se de que não haja regras de negação conflitantes

1. Verifique as ACLs de rede:
   + Verifique se as ACLs de rede no nível da sub-rede permitem tráfego de entrada na porta 1433
   + Certifique-se de que as ACLs de rede permitam portas efêmeras de saída para tráfego de retorno
   + Verifique as ACLs de rede da sub-rede do banco de dados e da sub-rede do DMS

1. Verifique a configuração da VPC:
   + Confirme se a instância de conversão do esquema DMS e o SQL Server estão na mesma VPC ou têm o emparelhamento de VPC adequado
   + Verifique se as tabelas de rotas permitem o tráfego entre sub-redes
   + Verifique se nenhum dispositivo de firewall está bloqueando o tráfego

1. Teste a conectividade:
   + Execute uma instância EC2 de teste na mesma sub-rede do DMS Schema Conversion
   + Anexe o mesmo grupo de segurança que o DMS Schema Conversion
   + Teste a conexão com o SQL Server usando telnet ou SQL Server Management Studio
   + Se o teste for bem-sucedido, o problema é com a configuração do AWS Transform; se falhar, o problema é network/firewall

**Erro comum:** abrir a porta 1433 para 0.0.0. 0/0 (todas as fontes) é um risco de segurança. Sempre use o controle de acesso baseado em grupos de segurança para limitar o acesso somente ao grupo de segurança DMS Schema Conversion.

## Problemas de conversão de esquema
<a name="schema-conversion-issues"></a>

**Problema:** a conversão do esquema mostra muitos itens de ação

Soluções:
+ Revise os itens de ação no relatório de conversão
+ Priorize com base no impacto
+ Use o Amazon Q Developer para conversões complexas de SQL
+ Consulte o AWS Support para obter orientação
+ Considere a abordagem em fases para bancos de dados complexos

## Problemas de transformação de aplicativos
<a name="application-transformation-issues"></a>

**Problema:** falha na construção da transformação do aplicativo

Soluções:
+ Analise os erros de construção no relatório de transformação
+ Configure NuGet feeds privados, se necessário
+ Atualize as referências do pacote, se necessário
+ Verifique as Windows-specific dependências
+ Analise os registros de transformação para ver erros detalhados

## Problemas de migração de dados
<a name="data-migration-issues"></a>

**Problema:** falha na validação da migração de dados

Soluções:
+ Revise o relatório de validação para falhas específicas
+ Verifique os mapeamentos de tipos de dados
+ Verifique a configuração da coluna de identidade (GERADA POR PADRÃO versus GERADA SEMPRE)
+ Revise as expressões de coluna computadas
+ Entre em contato com o AWS Support para problemas complexos de dados

## Problemas de limpeza de recursos
<a name="resource-cleanup-issues"></a>

**Problema:** falha na tarefa de transformação com erros de recursos

Soluções:
+ Verifique os recursos existentes do DMS (projetos de migração, provedores de dados, perfis de instância)
+ Limpe recursos falhados ou incompletos de tentativas anteriores
+ Verifique se os segredos não estão programados para exclusão
+ Verifique as cotas de serviço para DMS e Aurora PostgreSQL
+ Entre em contato com o AWS Support se a limpeza não resolver o problema

## Problemas de implantação
<a name="deployment-issues"></a>

**Problema: o** aplicativo transformado não consegue se conectar ao Aurora PostgreSQL

Soluções:
+ Verifique o formato da cadeia de conexão para o PostgreSQL
+ Verifique as regras do grupo de segurança
+ Verifique as credenciais do banco de dados no Secrets Manager
+ Verifique SSL/TLS se está configurado corretamente
+ Teste a conexão usando psql ou pgAdmin

## Obter ajuda adicional
<a name="getting-additional-help"></a>

Ao entrar em contato com o AWS Support, forneça:
+ ID do trabalho de transformação
+ AWS ID da conta
+ Região
+ Mensagens de erro e capturas de tela
+ Registros de transformação (disponíveis no console do AWS Transform)