Integração do Amazon EFS

O Amazon Elastic File System (Amazon EFS) fornece armazenamento de arquivos sem servidor e totalmente elástico para que você possa compartilhar dados de arquivos sem provisionar ou gerenciar a capacidade e a performance do armazenamento. Com o Amazon EFS, você pode criar um sistema de arquivos e montá-lo em sua VPC por meio do protocolo NFS versões 4.0 e 4.1 (NFSv4). Depois, você pode usar o sistema de arquivos do EFS como qualquer outro sistema de arquivos compatível com POSIX. Para obter informações gerais, consulte O que é o Amazon Elastic File System? e o blog da AWS Integrar o Amazon RDS para Oracle com o Amazon EFS.

Visão geral da integração com o Amazon EFS

Com o Amazon EFS, é possível transferir arquivos entre uma instância de banco de dados do RDS para Oracle e um sistema de arquivos do EFS. Por exemplo, você pode usar o EFS para oferecer suporte aos seguintes casos de uso:

Vantagens da integração com o Amazon EFS

Ao escolher um sistema de arquivos do EFS em vez de soluções alternativas de transferência de dados, você recebe os seguintes benefícios:

Requisitos para a integração com o Amazon EFS

Certifique-se de cumprir os seguintes requisitos:

Configurar permissões de rede para a integração do RDS para Oracle com o Amazon EFS

Para que o RDS para Oracle se integre ao Amazon EFS, sua instância de banco de dados deve ter acesso de rede a um sistema de arquivos EFS. Para ter mais informações, consulte Controlling network access to Amazon EFS file systems for NFS clients (Controlar o acesso à rede aos sistemas de arquivos Amazon EFS para clientes do NFS) no Guia do usuário do Amazon Elastic File System.

Controlar acesso à rede com grupos de segurança

Você pode controlar o acesso de sua instância de banco de dados aos sistemas de arquivos EFS usando mecanismos de segurança da camada de rede, como grupos de segurança da VPC. Para permitir o acesso a um sistema de arquivos EFS para sua instância de banco de dados, seu sistema de arquivos EFS deve atender aos seguintes requisitos:

Para ter mais informações, consulte Creating Amazon EFS file systems (Criar sistemas de arquivos Amazon EFS) e Creating and managing EFS mount targets and security groups (Criar e gerenciar destinos de montagem e grupos de segurança do EFS) no Guia do usuário do Amazon Elastic File System.

Controlar o acesso à rede com políticas de sistema de arquivos

A integração do Amazon EFS com o RDS para Oracle funciona com a política padrão (vazia) do sistema de arquivos EFS. A política padrão não usa o IAM para se autenticar. Em vez disso, ele concede acesso total a qualquer cliente anônimo que possa se conectar ao sistema de arquivos usando um destino de montagem. A política padrão estará em vigor sempre que uma política de sistema de arquivos configurada pelo usuário não estiver em vigor, inclusive na criação do sistema de arquivos. Para ter mais informações, consulte Default EFS file system policy (Política padrão do sistema de arquivos EFS) no Guia do usuário do Amazon Elastic File System.

Para fortalecer o acesso ao seu sistema de arquivos EFS para todos os clientes, inclusive o RDS para Oracle, você pode configurar as permissões do IAM. Nessa abordagem, você cria uma política do sistema de arquivos. Para ter mais informações, consulte Creating file system policies (Criar políticas do sistema de arquivos) no Guia do usuário do Amazon Elastic File System.

Configurar permissões do IAM para a integração do RDS para Oracle com o Amazon EFS

Por padrão, o recurso de integração do Amazon EFS não usa um perfil do IAM: a configuração da opção USE_IAM_ROLE é FALSE. Para integrar o RDS para Oracle ao Amazon EFS e um perfil do IAM, a instância de banco de dados deve ter permissões do IAM para acessar um sistema de arquivos Amazon EFS.

Etapa 1: Criar um perfil do IAM para a instância de banco de dados e anexar a política

Nesta etapa, você criará uma função para a instância de banco de dados do RDS para Oracle para permitir que o Amazon RDS acesse o sistema de arquivos EFS.

aws iam create-role \
   --role-name rds-efs-integration-role \
   --assume-role-policy-document '{
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
            "Service": "rds.amazonaws.com"
          },
         "Action": "sts:AssumeRole",
         "Condition": {
             "StringEquals": {
                 "aws:SourceAccount": my_account_ID,
                 "aws:SourceArn": "arn:aws:rds:Region:my_account_ID:db:dbname"
             }
         }
       }
     ]
   }'

aws iam create-role ^
   --role-name rds-efs-integration-role ^
   --assume-role-policy-document '{
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
            "Service": "rds.amazonaws.com"
          },
         "Action": "sts:AssumeRole",
         "Condition": {
             "StringEquals": {
                 "aws:SourceAccount": my_account_ID,
                 "aws:SourceArn": "arn:aws:rds:Region:my_account_ID:db:dbname"
             }
         }
       }
     ]
   }'

Etapa 2: Criar uma política para seu sistema de arquivos Amazon EFS

Nesta etapa, crie uma política para seu sistema de arquivos EFS.

Etapa 3: Associar um perfil do IAM à sua instância de banco de dados do RDS para Oracle

Nesta etapa, associe um perfil do IAM à instância de banco de dados. Esteja ciente dos seguintes requisitos:

Para ter mais informações, consulte Identity and access management for Amazon EFS (Identity and access management para Amazon EFS) no Guia do usuário do Amazon Elastic File System.

aws rds add-role-to-db-instance \
   --db-instance-identifier mydbinstance \
   --feature-name EFS_INTEGRATION \
   --role-arn your-role-arn                    

aws rds add-role-to-db-instance ^
   --db-instance-identifier mydbinstance ^
   --feature-name EFS_INTEGRATION ^
   --role-arn your-role-arn

Adicionar a opção EFS_INTEGRATION

Para usar o Amazon RDS para Oracle com Amazon EFS, sua instância de banco de dados deve estar associada a um grupo de opções que inclua a opção EFS_INTEGRATION.

Várias instâncias de banco de dados Oracle que pertencem ao mesmo grupo de opções compartilham o mesmo sistema de arquivos EFS. Instâncias de banco de dados diferentes podem acessar os mesmos dados, mas o acesso pode ser dividido com o uso de diferentes diretórios Oracle. Para ter mais informações, consulte Transferir arquivos entre o RDS para Oracle e um sistema de arquivos Amazon EFS.

Configurar permissões do sistema de arquivos Amazon EFS

Por padrão, somente o usuário raiz (UID 0) tem permissões de leitura, gravação e execução para um sistema de arquivos EFS recém-criado. Para os outros usuários modificarem o sistema de arquivos, o usuário raiz deve conceder explicitamente acesso a eles. O usuário da instância de banco de dados do RDS para Oracle está na categoria others. Para ter mais informações, consulte Working with users, groups, and permissions at the Network File System (NFS) Level (Trabalhar com usuários, grupos e permissões no nível do Network File System (NFS)) no Guia do usuário do Amazon Elastic File System.

Para permitir que a instância de banco de dados do RDS para Oracle leia e grave arquivos em um sistema de arquivos EFS, faça o seguinte:

Por exemplo, para conceder a other usuários permissões para gravar na raiz do sistema de arquivos EFS, execute chmod 777 nesse diretório. Para ter mais informações, consulte Example Amazon EFS file system use cases and permissions (Exemplos de casos de uso e permissões do sistema de arquivos Amazon EFS) no Guia do usuário do Amazon Elastic File System.

Transferir arquivos entre o RDS para Oracle e um sistema de arquivos Amazon EFS

Para transferir arquivos entre uma instância do RDS para Oracle e um sistema de arquivos do Amazon EFS, crie pelo menos um diretório Oracle e configure as permissões do sistema de arquivos EFS para controlar o acesso à instância de banco de dados.

Criar um diretório Oracle

Para criar um diretório da Oracle, use o procedimento rdsadmin.rdsadmin_util.create_directory_efs. O procedimento tem os seguintes parâmetros.

/rdsefs-fs-1234567890abcdef0/mydir

Suponha que você crie um subdiretório denominado /datapump1 no sistema de arquivos EFS fs-1234567890abcdef0. O exemplo a seguir cria um diretório Oracle DATA_PUMP_DIR_EFS que aponta para o diretório /datapump1 no sistema de arquivos EFS. O valor do caminho do sistema de arquivos para o parâmetro p_path_on_efs é prefixado com a string /rdsefs-.

BEGIN
  rdsadmin.rdsadmin_util.create_directory_efs(
    p_directory_name => 'DATA_PUMP_DIR_EFS', 
    p_path_on_efs    => '/rdsefs-fs-1234567890abcdef0/datapump1');
END;
/

Transferir dados de e para um sistema de arquivos EFS: exemplos

O exemplo a seguir usa o Oracle Data Pump para exportar a tabela denominada MY_TABLE para o arquivo datapump.dmp. Esse arquivo reside em um sistema de arquivos EFS.

DECLARE
  v_hdnl NUMBER;
BEGIN
  v_hdnl := DBMS_DATAPUMP.OPEN(operation => 'EXPORT', job_mode => 'TABLE', job_name=>null);
  DBMS_DATAPUMP.ADD_FILE(
    handle    => v_hdnl,
    filename  => 'datapump.dmp',
    directory => 'DATA_PUMP_DIR_EFS',
    filetype  => dbms_datapump.ku$_file_type_dump_file);
  DBMS_DATAPUMP.ADD_FILE(
    handle    => v_hdnl,
    filename  => 'datapump-exp.log',
    directory => 'DATA_PUMP_DIR_EFS',
    filetype  => dbms_datapump.ku$_file_type_log_file);
  DBMS_DATAPUMP.METADATA_FILTER(v_hdnl,'NAME_EXPR','IN (''MY_TABLE'')');
  DBMS_DATAPUMP.START_JOB(v_hdnl);
END;
/

O exemplo a seguir usa o Oracle Data Pump para importar a tabela denominada MY_TABLE do arquivo datapump.dmp. Esse arquivo reside em um sistema de arquivos EFS.

DECLARE
  v_hdnl NUMBER;
BEGIN
  v_hdnl := DBMS_DATAPUMP.OPEN(
    operation => 'IMPORT',
    job_mode  => 'TABLE',
    job_name  => null);
  DBMS_DATAPUMP.ADD_FILE(
    handle    => v_hdnl,
    filename  => 'datapump.dmp',
    directory => 'DATA_PUMP_DIR_EFS',
    filetype  => dbms_datapump.ku$_file_type_dump_file );
  DBMS_DATAPUMP.ADD_FILE(
    handle    => v_hdnl,
    filename  => 'datapump-imp.log',
    directory => 'DATA_PUMP_DIR_EFS',
    filetype  => dbms_datapump.ku$_file_type_log_file);
  DBMS_DATAPUMP.METADATA_FILTER(v_hdnl,'NAME_EXPR','IN (''MY_TABLE'')');
  DBMS_DATAPUMP.START_JOB(v_hdnl);
END;
/

Para ter mais informações, consulte Importar dados para o Oracle no Amazon RDS.

Remover a opção EFS_INTEGRATION

Para remover a opção EFS_INTEGRATION de uma instância de banco de dados do RDS para Oracle, realize um dos seguintes procedimentos:

Solução de problemas de integração do Amazon EFS

A instância de banco de dados do RDS para Oracle monitora a conectividade com um sistema de arquivos Amazon EFS. Quando o monitoramento detecta um problema, ele pode tentar corrigi-lo e publicar um evento no console do RDS. Para ter mais informações, consulte Visualizar eventos do Amazon RDS.

Utilize as informações desta seção para ajudar a diagnosticar e corrigir problemas comuns ao trabalhar com a integração do Amazon EFS.