Alimentando Dados

Você pode executar um feed dinâmico de tabela sob demanda, em uma programação ou como resultado de uma notificação.

Um Live Table Feed automatiza o carregamento de dados em uma tabela no banco de dados. Os arquivos são carregados automaticamente conforme aparecem no armazenamento de objetos e o sistema Live Table Feed garante que os arquivos sejam carregados apenas uma vez. O carregamento pode acontecer manualmente, por uma programação ou até mesmo por notificações entregues diretamente do Object Storage.

O bucket pode conter arquivos nestes formatos: AVRO, CSV, JSON, GeoJSON, Parquet, ORC, TXT Delimitado. Todos os arquivos devem ter a mesma assinatura de coluna.

Gerenciar conexões de armazenamento na nuvem para feeds de tabela ativa

Antes de criar um feed de tabela ativa, estabeleça uma conexão com o armazenamento na nuvem que você deseja usar:

  1. Clique em Conexões no menu Carga de Dados. Para obter instruções, consulte Gerenciando Conexões.

Criar um Objeto de Feed de Tabela Ativa

Para criar um objeto de feed de tabela ativa,
  1. Na página Live Feed, clique no botão + Criar Feed de Tabela Ativa para exibir o painel Definições do Live Feed. Insira informações na guia Origem de Dados da seguinte forma:
    • Local do Cloud Store: Selecione o Local do Cloud Store no menu suspenso. Selecione a conexão na nuvem do bucket que contém o arquivo que você deseja usar para alimentar dados.

      No modo Básico, você pode exibir as seguintes opções:

    • Pastas:

      Selecione a pasta que contém o(s) arquivo(s) que deseja usar para alimentar dados no armazenamento de objetos. Selecione Bucket Inteiro para carregar todos os arquivos do seu bucket na sua tabela. As pastas são listadas e organizadas no menu suspenso com base em como você cria pastas ou diretórios e armazena seus arquivos. Por exemplo, você pode criar uma pasta de vendas para armazenar arquivos sales1.csv e sales2.csv.

    • Extensões:

      Informe uma extensão para limitar o feed de tabela ativa apenas aos arquivos no bucket que correspondem à extensão. Por exemplo, para limitar os arquivos apenas àqueles que são arquivos CSV, selecione CSV.

      No modo Avançado, você pode exibir as seguintes opções:

    • Filtro de Objeto (glob): Informe um glob de arquivo para limitar o feed de tabela ativa apenas aos arquivos no bucket que correspondem ao glob. Por exemplo, para limitar os arquivos apenas àqueles que são arquivos CSV, digite *.CSV.

    • Na seção Visualização do arquivo do Live Feed, você pode visualizar o arquivo selecionado na etapa anterior.

    Clique em Próximo para avançar para a guia Definições da Tabela.

    No campo Opção, selecione qualquer uma das duas opções disponíveis:
    • Carregar Tabela: Esta opção anexa o feed à tabela de destino. Ele adiciona novas linhas à tabela para cada arquivo exibido.

    • Mesclar na Tabela: Esta opção mescla dados de live feed na tabela de destino. Clique em Mesclar Chave na seção Mapeamento quando a linha já existir e a chave carregada corresponder ao feed recém-adicionado. Isso evita a inserção de uma nova linha.

    • Coleta de Carga: Você pode definir seu livefeed em arquivos JSON com essa opção. Ao selecionar esta opção, você não exibirá a seção de mapeamento e a seção Adicionar Expressão. A ferramenta carrega os dados de origem em uma coleção JSON que você pode extrair posteriormente.

    Nome da Tabela de Destino: Aceite o nome padrão ou digite outro nome. Esse é o nome da tabela de destino na qual os dados do live feed serão carregados na instância do Autonomous Database. Se a tabela não existir, o Live Feed tentará adivinhar as colunas corretas. Você pode pré-criar a tabela na qual deseja que o Live Feed seja carregado. Isso é para maior precisão.

    A guia Configurações da Tabela especifica opções para controlar como os dados de origem são interpretados, visualizados e processados. Essas opções variam, dependendo do tipo de dados de origem.
    • Codificação: Selecione um tipo de codificação de caracteres na lista. Essa opção está disponível quando o arquivo vinculado está em formato simples (CSV, TSV ou TXT). O tipo de codificação padrão é UTF-8.
    • Divulgação de texto: Selecione o caractere para delimitar o texto: " ( caractere de aspas duplas),' ( caractere de aspas simples) ou Nenhum. Essa opção só fica visível quando o arquivo selecionado está em formato de texto simples (CSV, TSV ou TXT).
    • Delimitador de campo: Selecione o caractere delimitador usado para separar colunas na origem. Por exemplo, se o arquivo de origem usar ponto-e-vírgula para delimitar as colunas, selecione Ponto-e-vírgula nessa lista. O padrão é Vírgula. Essa opção só fica visível quando o arquivo selecionado está em formato de texto simples (CSV, TSV ou TXT).
    • Iniciar processamento de dados na linha: Especifica o número de linhas a serem ignoradas ao vincular os dados de origem à tabela externa de destino:

      Se você selecionar a opção Linha do cabeçalho da coluna em Nome da coluna de origem (veja a seguir) e digitar um número maior que 0 no campo Iniciar processamento de dados na linha, esse número de linhas após a primeira linha não será vinculado ao destino.

      Se você desmarcar a opção Linha do cabeçalho da coluna em Nome da coluna de origem e informar um número maior que 0 no campo Iniciar processamento de dados na linha, esse número de linhas, incluindo a primeira linha, não será vinculado ao destino.

      Linha do cabeçalho da coluna: Marque a caixa de seleção Linha do cabeçalho da coluna para usar os nomes de coluna da tabela de origem na tabela de destino.

      Se você selecionar essa opção, a primeira linha do arquivo será processada como nomes de coluna. As linhas na seção Mapeamento, abaixo, são preenchidas com esses nomes (e com os tipos de dados existentes, a menos que você os altere).

      Se você desmarcar essa opção, a primeira linha será processada como dados. Para especificar nomes de coluna manualmente, informe um nome para cada coluna de destino na seção Mapeamento. (Você também precisará informar tipos de dados).

      Marque a caixa de seleção Convert invalid data to null para converter um valor de coluna numérico inválido em um valor nulo.

      Novas linhas incluídas nos valores de dados: Selecione essa opção se houver caracteres de nova linha ou retornar ao início da linha atual sem avançar para baixo nos campos de dados. Selecionar esta opção aumentará o tempo necessário para processar o carregamento. Se você não selecionar essa opção ao carregar os dados, as linhas com novas linhas nos campos serão rejeitadas. É possível visualizar a linha rejeitada no painel Relatório de Tarefas.

    • Edite ou atualize as definições da tabela na seção Mapeamento: Neste painel, o mapeamento das colunas de origem para destino é exibido.

      O conteúdo da tabela Mapeamento muda de acordo com a opção de processamento que você escolheu na seção Tabela e as propriedades que definiu na seção Propriedades.

      Você pode filtrar os resultados na tabela de mapeamento com o campo Filtro Rápido que permite filtrar Colunas ou Expressões.

      Selecione Adicionar Expressão para executar Análise de Sentimentos, Extração de Frase-Chave, Detecção de Idioma ou Tradução de Textocom os dados de origem. Consulte Usar Recursos do OCI Language Service no Data Studio para obter mais detalhes.

      • Marque a caixa de seleção Incluir no início de uma linha para adicionar a coluna à tabela de destino.
      • Selecione ou informe valores para atributos de coluna, como Nome da Coluna de Destino, Tipo de Coluna, Precisão, Escala, Padrão, Chave Primária e Anulável.
      • É necessário revisar o tipo de dados sugerido e, se necessário, modificá-lo inserindo o tipo de dados diretamente na célula de destino.

        Revise o código da tabela de mapeamento gerado com base nas seleções feitas nas telas anteriores.

        Clique em Mesclar Chave na seção Mapeamento quando a linha já existir e a chave carregada corresponder ao feed recém-adicionado. Isso evita a inserção de uma nova linha. Essa opção é exibida quando você seleciona a opção Mesclar na Tabela.

      Clique em Próximo para avançar para a guia Visualizar.

    • O Painel de Visualização exibe as alterações feitas na tabela.

    • Clique em Próximo para avançar para a guia Definições do Live Feed.

    Na guia Configurações do Live Feed, especifique os seguintes valores de campo:

    • Nome do Feed de Tabela Ativa: Aceite o nome padrão ou digite outro para identificar esse feed de tabela ativa.

    • Ativar para Notificação: Selecione essa opção para que dados novos ou alterados na origem de dados sejam carregados com base em uma notificação do Oracle Cloud Infrastructure. Ao selecionar essa opção, você pode evitar atrasos que podem ocorrer quando a pesquisa é iniciada em uma programação (ou seja, se você tiver selecionado a opção Programado do feed de tabela ativa).

      Ao selecionar a opção Ativar para Notificação, você também deve:

      • Configurar seu bucket de armazenamento de objetos para emitir notificações
      • Criar um tópico de assinatura do serviço Notifications
      • Criar uma regra do serviço Events
      • Copiar o URL de notificação
      • Criar uma assinatura do serviço Notifications
      • Confirmar se notificações são permitidas

      Para obter instruções completas, consulte Criando um Feed de Tabela Ativa Baseado em Notificação.

    • Ativar para Programação: Selecione essa opção para configurar uma programação para executar o objeto de feed de tabela ativa; ou seja, sondar a origem de dados regularmente:
      • Nos campos de intervalo de tempo, digite um número e selecione um tipo de tempo e os dias em que o bucket será sondado em busca de arquivos novos ou alterados. Por exemplo, para sondar a cada duas horas, segunda, quarta e sexta-feira, digite 2 e selecione Horas. Você pode selecionar Todos os Dias, Segunda a Sexta-feira, Domingo a Quinta-feira ou Personalizado no menu suspenso Dias da Semana. O campo Personalizado permite que você selecione Segunda-feira, Terça-feira, Quarta-feira, Quinta-feira e Sexta-feira nos campos apropriados.

      • Selecione as datas inicial e final com as horas inicial e final. Se você não selecionar uma data inicial, a hora e a data atuais serão usadas como data inicial. A data final é opcional. No entanto, sem uma data final, o live feed continuará a fazer pesquisas.

    Selecione um grupo de consumidores no menu suspenso, ou seja, baixo, médio e alto.

  2. Clique em Criar para criar o objeto de feed da Tabela Ativa.

    Mostrar código: Selecione esta opção para exibir o equivalente de código PL/SQL do assistente Criar Feed de Tabela Ativa. Você pode copiar e executar esse código PL/SQL na planilha para executar a mesma ação que ocorre quando você clica em Criar no assistente Criar Feed de Tabela Ativa.

Listar, filtrar e classificar objetos de feed de tabela ativa

Quando você abre a página Live Feed, os objetos de feed de tabela ativa existentes são exibidos como cartões na página. Eles são identificados como entidades LIVE_TABLE_FEED.

Para filtrar objetos de feed de tabela ativa:

  1. Clique no campo de pesquisa na parte superior da página para exibir as opções de filtro. Por padrão, os objetos de feed de tabela ativa do esquema do usuário atual são mostrados. Assim que você começa a digitar no campo de pesquisa, a ferramenta de alimentação retorna os valores que contêm as letras que você digita. Você pode remover o filtro excluindo o conteúdo da caixa de pesquisa e clicando no ícone de cruz que aparece ao lado da caixa.

  2. Para incluir objetos de outros esquemas, selecione a lista suspensa ao lado do campo de pesquisa, em Esquema. Para remover um esquema da lista de filtros, desmarque a caixa ao lado do nome.

  3. Para mostrar objetos de todos os esquemas disponíveis, selecione Todos na lista drop-down Esquema.

Para classificar objetos de feed de tabela ativa

  1. Clique no botão Classificar por na parte superior direita da página.

  2. Selecione uma opção de classificação. Para classificar em ordem crescente, clique no ícone de seta para cima. Para classificar em ordem decrescente, clique no ícone de seta para baixo.

Localizar e Exibir Objetos de Feed de Tabela Ativa

Para procurar entidades de feed de tabela ativa disponíveis nos esquemas selecionados, digite um valor no campo de pesquisa na parte superior da página e pressione Enter. A exibição inclui apenas as entidades cujos nomes contenham os caracteres no campo de pesquisa. Para limpar o campo de pesquisa, clique no ícone Limpar resultados da pesquisa (X) no campo de pesquisa.

Para remover um esquema ou um valor de classificação dos filtros selecionados, desmarque o esquema ou o valor de classificação no painel de filtro ou clique no ícone Remover filtro (X) do esquema ou no valor de classificação acima da exibição dos objetos de feed da tabela ativa. Para fechar o painel de filtro, clique no ícone Ocultar painel de filtro (X) no painel.

Para atualizar a exibição de feeds de tabela ativa, clique no ícone Atualizar na parte superior da página.

Editar um Objeto de Feed de Tabela Ativa

Para editar detalhes de um objeto de feed de tabela ativa,
  1. Na página Live Feed, localize o cartão do feed de tabela ativa cujos detalhes você deseja editar.
  2. Clique no ícone Ações ( três pontos) no cartão e selecione Editar Feed de Tabela Ativa. Você pode editar as seguintes opções:
    • Especifique informações na guia Origem de Dados da seguinte forma:
    • Local do Cloud Store: Selecione o Local do Cloud Store no menu suspenso. Selecione a conexão de nuvem para o bucket que contém o arquivo que você deseja usar para alimentar dados.
      • No modo Básico, você pode exibir as seguintes opções:

      • Pastas:

        Selecione a pasta que contém o arquivo que você deseja usar para alimentar dados no armazenamento de objetos. Selecione Bucket Inteiro para fazer upload de todos os arquivos para seu bucket. As pastas são listadas e organizadas no menu suspenso com base em como você cria pastas ou diretórios e armazena seus arquivos. Por exemplo, você pode criar uma pasta de vendas para armazenar arquivos sales1.csv e sales2.csv.

      • Extensões:

        Informe uma extensão para limitar o feed de tabela ativa apenas aos arquivos no bucket que correspondem à extensão. Por exemplo, para limitar os arquivos apenas àqueles que são arquivos CSV, selecione CSV.

        No modo Avançado, você pode exibir as seguintes opções:

      • Filtro de Objeto (glob): Informe um glob de arquivo para limitar o feed de tabela ativa apenas aos arquivos no bucket que correspondem ao glob. Por exemplo, para limitar os arquivos apenas àqueles que são arquivos CSV, digite *.CSV.

    • Na guia Definições de Feed Ativo, edite os seguintes campos:

    • Ativar para Notificação: Selecione essa opção para que dados novos ou alterados na origem de dados sejam carregados com base em uma notificação do Oracle Cloud Infrastructure. Ao selecionar essa opção, você pode evitar quaisquer atrasos que possam ocorrer quando a polling é iniciada em uma programação (ou seja, a opção Programado do feed de tabela ativa).

      Ao selecionar a opção Ativar para Notificação, você também deve:

      • Copiar o URL de notificação de feeds de tabela ativa
      • Configurar seu armazenamento na nuvem para emitir notificações
      • Configure o Oracle Cloud Infrastructure para rotear eventos para o ponto final usado para o feed de tabela ativa.
      • Crie uma regra.
      • Criar uma assinatura.
      • Confirme se as notificações são permitidas no serviço live feed.

      Para obter instruções completas, consulte Criando um Feed de Tabela Ativa Baseado em Notificação.

    • Programado: Selecione essa opção para configurar uma programação para executar o objeto de feed de tabela ativa; ou seja, sondar a origem de dados regularmente:
      • Nos campos de intervalo de tempo, digite um número e selecione um tipo de tempo e os dias em que o bucket será sondado em busca de arquivos novos ou alterados. Por exemplo, para sondar a cada duas horas, segunda, quarta e sexta-feira, digite 2 e selecione Horas. Você pode selecionar Todos os Dias, Segunda a Sexta-feira, Domingo a Quinta-feira ou Personalizado no menu suspenso Dias da Semana. O campo Personalizado permite que você selecione Segunda-feira, Terça-feira, Quarta-feira, Quinta-feira e Sexta-feira nos campos apropriados.

      • Selecione as datas inicial e final com as horas inicial e final.

  3. Clique em Salvar.

Executar um Feed de Tabela Ativa

Você pode executar um feed dinâmico de tabela sob demanda, em uma programação ou como resultado de uma notificação.

Para executar um feed de tabela ativa sob demanda:

  1. Na página Live Feed, localize o cartão do feed de tabela ativa que você deseja executar.
  2. Clique no ícone Actions (três pontos) no cartão e selecione Run Live Table Feed Immediately (Once).

Para executar um feed de tabela ativa em uma programação:

Você pode definir uma programação para executar feeds de tabela ativa no painel Criar Feed de Tabela Ativa (ao criar um novo feed de tabela) ou no painel Editar Feed de Tabela Ativa (ao editar um feed de tabela existente). Consulte Create a Live Table Feed Object ou Edit a Live Table Feed Object.

Para executar um feed de tabela ativa como resultado de uma notificação:

Consulte Criando um Feed de Tabela Ativa Baseado em Notificação.

Marque a caixa de seleção Programado para exibir as opções de programação e, em seguida, defina a programação selecionando as opções desejadas.

Para exibir detalhes da execução do feed de tabela ativa:

  1. Na página Live Feed, localize o cartão do feed de tabela ativa cujos detalhes de execução você deseja ver.
  2. Clique no ícone Ações ( três pontos) no cartão e selecione Detalhes da Execução do Feed de Tabela Ativa.

    A guia Objetos no painel Detalhes da Execução do Feed de Tabela Ativa exibe informações sobre os jobs, como quando a execução, os objetos envolvidos na execução, o proprietário da tabela, o Nome da tabela, o status do live feed, as linhas carregadas e rejeitadas e outros detalhes. Clique na guia Tudo para exibir mais detalhes, como o tipo de evento.

Excluir um Feed de Tabela Ativa

  1. Na página Live Feed, localize o cartão do job de feed de tabela ativa que você deseja excluir.
  2. Clique no ícone Ações ( três pontos) no cartão e selecione Excluir Feed de Tabela Ativa.

Criando um Feed de Tabela Ativa Baseado em Notificação

Você pode carregar dados por meio de um feed de tabela ativa com base em uma nota do Oracle Cloud Infrastructure.

Além de poder executar um feed de tabela ativa sob demanda ou em uma programação, conforme descrito em Alimentando Dados, você também pode executar um feed como resultado de uma notificação. Quando os dados no bucket de origem são alterados, uma notificação é enviada, o que aciona uma execução do feed de tabela. Com um feed de tabela ativa baseado em notificação, você pode evitar qualquer atraso que possa vir da execução de jobs de feed de tabela ativa sob demanda ou programados.

Observação

  • Os feeds de tabela ativa baseados em notificação não estão disponíveis na camada gratuita do Oracle Cloud Infrastructure. Você deve estar em uma tenancy paga com permissões apropriadas em sua conta para usar esse recurso.

  • Os feeds de tabela ativa baseados em notificação não estão disponíveis nos Bancos de Dados Oracle Autonomous Data Warehouse (ADW) que são configurados usando um ponto final privado.

Para criar um feed de tabela ativa baseado em notificação:

Dica:

Para concluir essas etapas, você alternará entre as páginas da Console do Oracle Cloud Infrastructure e as páginas do Oracle Database Actions. Talvez seja conveniente abrir a Console da Nuvem em uma página ou guia do browser e o Database Actions em outra, para que seja fácil mover-se para frente e para trás.

Etapa 1: Configurar seu bucket de armazenamento de objetos para emitir notificações

Onde: Console do Oracle Cloud Infrastructure: Armazenamento de Objetos e Armazenamento de Arquivos Compactados - página Buckets

Configure o bucket que contém seus dados de origem para que ele emita notificações quando os dados forem alterados. Você pode definir essa opção ao criar um bucket ou pode configurá-la em um bucket existente.

  1. Abra o menu de navegação da Console da Nuvem e clique em Armazenamento. Em Object Storage e Archive Storage, clique em Buckets.
  2. Se você estiver criando um novo bucket:

    1. Na página Buckets, clique no botão Criar Bucket para criar um novo bucket, conforme descrito em Gerenciando Buckets. No assistente Criar Bucket, selecione a opção Emitir Eventos de Objeto, com as outras opções do seu novo bucket.
    2. Clique em Criar.

    Se você estiver usando um bucket existente:

    1. Na página Buckets, clique no nome do bucket que você deseja usar, conforme descrito em Gerenciando Buckets.
    2. Na página Detalhes do Bucket, clique no link Editar ao lado de Fazer Commit do Serviço Object Events.
    3. Marque a caixa de seleção Emitir Eventos de Objeto e clique em Salvar Alterações.

Etapa 2: Criar um tópico de assinatura do serviço Notifications

Onde: Console do Oracle Cloud Infrastructure: Notifications - página Topics

  1. Abra o menu de navegação da Console da Nuvem e clique em Serviços do Desenvolvedor. Em Integração de Aplicativos, clique em Notificações.
  2. Clique em Criar Tópico, digite um nome e uma descrição opcional e clique em Criar.

Etapa 3: Criar uma regra do serviço Events

Onde: Console do Oracle Cloud Infrastructure: Events - página Regras

  1. Abra o menu de navegação da Console da Nuvem e clique em Observação e Gerenciamento. Em Serviço Events, clique em Regras.
  2. Clique em Criar Regra e preencha a página Criar Regra conforme descrito em Gerenciando Regras para Eventos.
    • Em Condições da Regra, selecione:
      • Condição: Tipo de Evento
      • Nome do Serviço: Object Storage
      • Tipo de Evento: Objeto - Criar
    • Em Ações, selecione:
  3. Clique em Criar Regra.

Etapa 4: Criar e configurar um feed de tabela ativa para usar notificações e copiar o URL de notificação

Onde: Database Actions: página Live Feeds.

Você pode configurar um feed de tabela ativa novo ou existente para usar notificações:

  1. Vá para a página Live Feeds do Database Actions, conforme descrito em Alimentando Dados.
  2. Crie ou edite um objeto de feed de tabela ativa, conforme descrito em Criar um Objeto de Feed de Tabela Ativa ou Edit a Live Table Feed Object. Selecione a opção Ativar para Notificação
  3. Clique em Criar ou Salvar.
  4. Clique no ícone Ações ( três pontos na vertical) no cartão do seu live feed e selecione Mostrar URL de Confirmação.
  5. Na caixa de diálogo URL de Notificação, clique no ícone Copiar para copiar o URL para a área de transferência. Convém copiá-lo para um arquivo temporário, para que você possa recuperá-lo posteriormente. Você usará esse URL na próxima etapa, Etapa 5: Criar uma assinatura do serviço Notifications.

Etapa 5: Criar uma assinatura do serviço Notifications

Onde: Console do Oracle Cloud Infrastructure: Notifications - página Assinaturas

  1. Volte para a Console do Oracle Cloud Infrastructure. Abra o menu de navegação e clique em Serviços ao Desenvolvedor. Em Integração de Aplicativos, clique em Notificações.
  2. Na página Notifications, clique na guia Inscrições (no lado esquerdo da página; o status será Ativo.
  3. Clique em Criar Assinatura e preencha a página Criar Assinatura:

Etapa 6: Confirmar se o ponto final pode receber notificações

Onde: Database Actions: página Live Feeds.

  1. Volte para a página Live Feeds do Database Actions e localize o cartão do feed de tabela ativa que você está configurando para um feed baseado em notificação.
  2. Você verá o cartão de live feed em um status Ativo.

Você receberá notificações por e-mail quando ocorrerem determinados eventos específicos do live feed.

Consulte Enviar E-mail usando a Ferramenta Live Feed para obter mais detalhes.

Depois que você finalizar as etapas acima, todos os novos arquivos carregados por upload para o bucket serão automaticamente carregados na tabela de feed de tabela ativa.

Criando um Feed de Tabela Ativa Baseado em Notificação usando o Amazon Simple Storage Service (S3)

Você pode integrar o Amazon Simple Storage Service (S3) e o Oracle Cloud Infrastructure (OCI) para automatizar o processo de notificações de live feed quando objetos de armazenamento que ele está observando tiverem atualizações. A seção a seguir fornece instruções para criar notificações de eventos no bucket do Amazon S3 no qual seus arquivos de dados estão armazenados.

Dica:

Para concluir essas etapas, você precisará alternar entre a console de Gerenciamento do Amazon Web Services (AWS) e as páginas do Oracle Database Actions. Você pode achar conveniente abrir o Amazon Web Services em uma página ou guia do browser e o Database Actions em outra, para que seja fácil avançar e voltar.

Etapa 1: Criar seu bucket de armazenamento de objetos no Amazon S3

Onde: Console de Gerenciamento do Amazon Web Services (AWS)

Configure e crie seu bucket contendo dados de origem para que ele emita notificações quando os dados forem alterados.
  1. Faça log-in na console de Gerenciamento da AWS e abra a console do Amazon S3.
  2. Na página inicial, clique no ícone Criar Bucket.
  3. Em Nome do bucket, digite um nome válido para seu bucket. Por exemplo: testbucket. Depois de criar o bucket, não será possível alterar o nome dele.
  4. Em Região, selecione a Região do Amazon Web Services (AWS) na lista drop-down. Por exemplo: us-west-2
  5. Nas definições do Bucket para Bloquear Acesso Público, selecione as definições de Blocar Acesso Público que você deseja aplicar ao bucket. É recomendável manter todas as configurações ativadas, a menos que você saiba que precisa desativar qualquer uma delas.
  6. Selecione Definições avançadas e aceite todas as opções padrão se quiser ativar o Bloqueio de Objeto S3. Esta etapa é opcional.
  7. Selecione Criar bucket.

Etapa 2: Criar Chaves de Acesso

Onde: Console de Gerenciamento da AWS

Para acessar o Amazon Simple Notification Service (SNS), você deverá ter credenciais que o Amazon Web Services (AWS) possa usar para validar suas solicitações. Essas credenciais devem ter permissões para acessar os tópicos do Amazon SNS. As etapas a seguir fornecem detalhes sobre as etapas para criar chaves de acesso usando o AWS IAM (Identity and Access Management) para fins de segurança.

  1. Faça log-in na console de Gerenciamento da AWS e abra a console do IAM (Identity and Access Management) da Amazon.
  2. No menu de navegação, selecione Usuários.
  3. Selecione seu nome de usuário.
  4. Na guia Credenciais de Segurança, selecione Criar chave de acesso.
  5. Copie o ID da chave de acesso e a Chave de acesso secreta na exibição. Cole-os em uma área de transferência.
  6. Para fazer download das chaves, selecione o ícone arquivo Download.csv. É possível armazenar o arquivo em um local seguro.

Etapa 3: Adicionar um Link de Armazenamento na Nuvem do Amazon S3

Onde: Database Actions: página Gerenciar Nuvem

Antes de criar um feed de tabela ativa, estabeleça uma conexão com o armazenamento na nuvem que você deseja usar.

  1. Clique no botão Gerenciar Armazenamento na Nuvem na parte superior da página para ir até a página Gerenciar Nuvem. Para obter mais instruções sobre como adicionar arquivos de origem que residem no armazenamento na nuvem fornecido pelo Amazon S3, consulte o tópico Criar um Link de Armazenamento na Nuvem do Amazon S3 em Gerenciando Conexões.
    Observação

    Cole o ID da chave de acesso e a chave de acesso secreta gerados na etapa anterior (Etapa 2: Criar Chaves de Acesso) em seus respectivos campos de texto na página Adicionar Armazenamento na Nuvem.

Etapa 4: Criar e configurar um feed de tabela ativa para usar notificações e copiar o URL de notificação

Onde: Database Actions: página Live Feeds.

A criação de um feed de tabela ativa permite carregar dados em tempo real de origens de armazenamento externo para tabelas no ADB. O armazenamento externo usado inclui contêineres do Oracle Object Store, AWS S3 ou Microsoft Azure.

Você pode configurar um feed de tabela ativa novo ou existente para usar notificações:

  1. Vá para a página Live Feeds do Database Actions, conforme descrito em Alimentando Dados.
  2. Crie ou edite um objeto de feed de tabela ativa, conforme descrito em Criar um Objeto de Feed de Tabela Ativa ou Edit a Live Table Feed Object. Selecione a opção Ativar para Notificação
  3. Clique em Criar ou Salvar.
  4. Clique no ícone Ações ( três pontos na vertical) no cartão do seu live feed e selecione Mostrar URL de Notificação.
  5. Na caixa de diálogo URL de Notificação, clique no ícone Copiar para copiar o URL para a área de transferência. Convém copiá-lo para um arquivo temporário, para que você possa recuperá-lo posteriormente. Você usará esse URL na etapa subsequente (Etapa 7: Criar uma assinatura do serviço de notificações).

Etapa 5: Criar um tópico de assinatura do serviço de notificações

Onde: Console do Amazon Simple Notification Service (SNS)

Você recebe notificações do Amazon S3 usando o tópico do Amazon Simple Notification Service (Amazon SNS). Adicione uma configuração de notificação ao seu bucket usando um tópico do Amazon SNS. Os tópicos do SNS são locais compartilhados que são usados para enviar notificações de vários eventos que acontecem nos buckets da AWS.

Durante a criação, você seleciona um nome e um tipo de tópico. Depois de criar um tópico, não é possível alterar o tipo nem o nome do tópico. Todas as outras opções de configuração são opcionais durante a criação do tópico, que você pode editar posteriormente.

Para acessar qualquer serviço da AWS, primeiro crie uma conta da AWS.

Navegue até a console de Gerenciamento da AWS e selecione Criar uma Conta da AWS.

Siga as instruções fornecidas no link do Amazon SNS para criar seu primeiro usuário e grupo de administradores do IAM. Agora você pode fazer log-in em qualquer um dos serviços da AWS como usuário do IAM.

  1. Faça log-in na console do Amazon SNS como usuário do IAM.
  2. Na página Tópicos, selecione Criar tópico.
  3. Especifique os campos a seguir na página Criar tópico, na seção Detalhes.
    • Tipo:Padrão (padrão ou FIFO)
    • Nome: notification-topic. Para um tópico FIFO, adicione FIFO ao final do nome.
    • Nome para Exibição: Esse campo é opcional.
  4. Expanda a seção Criptografia e selecione Desativar criptografia.
  5. Expanda a seção Política de acesso e configure permissões de acesso adicionais, se necessário. Por padrão, somente o proprietário do tópico pode publicar nele ou assiná-lo. Esta etapa é opcional. Editar o formato JSON da política com base nos detalhes do tópico que você informa. Aqui está uma amostra da política de acesso no formato JSON.
    { "Version": "2008-10-17",
    "Id": "__default_policy_ID",
    "Statement":[
    {"Sid": "__default_statement_ID",
    "Effect": "Allow",
    "Principal": {"AWS": "*"
    },"Action": [
            "SNS:Publish",
            "SNS:RemovePermission",
            "SNS:SetTopicAttributes",
            "SNS:DeleteTopic",
            "SNS:ListSubscriptionsByTopic",
            "SNS:GetTopicAttributes",
            "SNS:AddPermission",
            "SNS:Subscribe"
          ],
          "Resource": "arn:aws:sns:us-west-2:555555555555:notify-topic", //us-west-2 is the region
          "Condition": {
            "StringEquals": {
              "AWS:SourceOwner": "555555555555"
            }
          }
        },
        {
          "Sid": "s3_policy", //This field accepts string values
          "Effect": "Allow",
          "Principal": {
            "Service": "s3.amazonaws.com"
          },
          "Action": [
            "SNS:Publish"
          ],
          "Resource": "arn:aws:sns:us-west-2:555555555555:notify-topic", //notify-topic is the topic name
          "Condition": {
            "StringEquals": {
              "aws:SourceAccount": "555555555555" //This is the Account ID
            },
            "ArnLike": {
              "aws:SourceArn": "arn:aws:s3:*:*:testbucket /*testbucket is the s3 bucket name. You will get notifications only when file is uploaded to this
        bucket.*/
    "
            }
          }
        }
      ]
    }
    
  6. Expanda a seção Política de repetição da entrega (HTTP/S) para configurar como o Amazon SNS repete as tentativas de entrega de mensagem com falha. Esta etapa é opcional.
  7. Expanda a seção Log de status da entrega para configurar como o Amazon SNS registra a entrega de mensagens em CloudWatch. Esta etapa é opcional.
  8. Expanda a seção Tags para adicionar tags de metadados ao tópico. Esta etapa é opcional.
  9. Selecione Create topic.
  10. O Nome do tópico, o ARN (Amazon Resource Name) e o ID da conta da AWS do proprietário do tópico são exibidos na seção Detalhes.
  11. Copie o ARN do tópico para a área de transferência.

Etapa 6: Ativar e configurar notificações de eventos usando a console do Amazon S3

Onde: Console de Gerenciamento do Amazon S3

Você pode ativar eventos de bucket do Amazon S3 para enviar uma mensagem de notificação a um destino sempre que esses eventos ocorrerem. Configure notificações de evento para seu bucket do S3 para notificar o OCI quando houver uma atualização ou novos dados disponíveis a serem carregados. As etapas a seguir explicitam o procedimento a ser seguido na console do Amazon S3 para ativar notificações de eventos.

  1. Faça log-in na console de Gerenciamento do Amazon S3 e acesse como usuário do Amazon IAM (Identity and Access Management).
  2. Na lista Buckets, selecione o nome do bucket, isto é, testbucket. Este é o bucket que você criou na Etapa 1: Criar seu bucket de armazenamento de objetos no Amazon S3.
  3. Selecione o ícone Properties.
  4. Navegue até a seção Notificações de Evento e selecione o ícone Criar notificação de evento.
  5. Na seção Configuração geral, especifique os valores a seguir para notificação de evento.
    • Nome do evento: bucket-notification
    • Prefixo: Esse valor é para filtrar notificações de evento por prefixo. Trata-se de um valor opcional. Isso é adicionado para filtrar a atividade do evento.
    • Sufixo: Esse valor é para filtrar notificações de evento por sufixo. Trata-se de um valor opcional. Isso é adicionado para filtrar a atividade do evento.
  6. Na seção Tipos de evento, selecione um ou mais tipos de evento sobre os quais você deseja receber notificações. Se você não tiver certeza de quais tipos de evento selecionar, selecione a opção Todos os eventos de criação de objeto.
  7. Na seção Destino, selecione Tópico do SNS como destino da notificação de evento.
    Observação

    Para poder publicar notificações de evento, conceda ao Amazon S3 as permissões necessárias para chamar a API relevante. Isso permite publicar notificações em uma função do Lambda ou em um tópico do SNS.
  8. Depois de selecionar o tópico do SNS como destino da notificação de evento, selecione o tópico do SNS, isto é, notification-topic, na lista drop-down. Esse é o tópico que você criou na Etapa 5: Criar um tópico de assinatura do serviço de notificações.
  9. Selecione Salvar alterações.

Etapa 7: Criar uma assinatura do serviço de notificações

Onde: Console do Amazon SNS

Cada tópico do Amazon SNS tem um conjunto de assinaturas. Depois que uma mensagem é publicada em um tópico, o SNS controla a distribuição da mensagem a todos os seus assinantes. Os assinantes podem ser funções do AWS Lambda, pontos finais HTTP(S), endereços de e-mail e números de telefone celular capazes de receber mensagens SMS.

O Amazon SNS corresponde o tópico com uma lista de assinantes que assinaram esse tópico e entrega a mensagem a cada um desses assinantes.

  1. Faça log-in na console do Amazon SNS.
  2. No painel de navegação esquerdo, selecione Inscrições.
  3. Selecione Criar assinatura na página de assinaturas.
  4. Na seção Detalhes da página Criar inscrição, especifique os valores a seguir.
  5. Expanda a seção Política de filtro de assinatura para configurar uma política de filtro. Esta etapa é opcional.
  6. Expanda a seção Política de renovação (fila de mensagens não processadas) para configurar uma fila de mensagens não processadas para a assinatura. Esta etapa é opcional.
  7. Selecione Criar assinatura.
Observação

Pontos finais HTTP(S), endereços de e-mail e recursos da AWS em outras contas da AWS exigem confirmação da assinatura para que possam receber mensagens.

Etapa 8: Confirmar se o ponto final pode receber notificações

Onde: Database Actions: página Live Feeds.

  1. Volte para a página Live Feeds do Database Actions e localize o cartão do feed de tabela ativa que você está configurando para um feed baseado em notificação.
  2. Clique no ícone Ações ( três pontos na vertical) no cartão e selecione Mostrar URL de Confirmação.
  3. Na caixa de diálogo URL de Confirmação, clique no link para confirmar o URL. Isso não fecha essa caixa de diálogo. Se o link for bem-sucedido, será exibida uma mensagem confirmando que a assinatura está ativa.
  4. Volte para a caixa de diálogo URL de Confirmação e marque a caixa de seleção Verificar somente quando o processo de confirmação do Cloud Store estiver concluído e clique em OK.

Depois que você finalizar as etapas acima, todos os novos arquivos carregados por upload para o bucket serão automaticamente carregados na tabela de feed de tabela ativa.

Para obter mais informações sobre como ativar e configurar notificações de eventos usando a console do Amazon S3, consulte Ativando e configurando notificações de eventos usando a console do Amazon S3.

Criando um Feed de Tabela Ativa Baseado em Notificação usando o Microsoft Azure

Um Feed de Tabela Ativa baseado em notificação é uma interface entre o Oracle Cloud Infrastructure e um serviço de fila de mensagens na nuvem de terceiros, como o Azure Event Grid.

A seção a seguir explica o procedimento para gerar mensagens automáticas do Live Feed usando o Microsoft (MS) Azure como armazenamento na nuvem. Quando há uma atualização no contêiner e as condições de notificação são atendidas, uma mensagem de log é gerada e exibida no live feed no Oracle Cloud Infrastructure.

Para criar um live feed baseado em notificação com o Microsoft Azure como armazenamento na nuvem, você deve:

Dica:

Para concluir as etapas acima, você precisará alternar entre o portal do Microsoft Azure e as páginas do Oracle Database Actions. Você pode achar conveniente abrir o portal do Microsoft Azure em uma página ou guia do browser e o Database Actions em outra, para que seja fácil avançar e voltar.

Etapa 1: Criar um grupo de recursos no Microsoft Azure

Onde: Portal do Microsoft Azure

Grupos de recursos são contêineres lógicos nos quais você pode gerenciar recursos do Azure, como contas de armazenamento. Os grupos de recursos são criados para que você possa implantar, atualizar e excluí-los como grupo. Você pode criar um grupo de recursos seguindo estas etapas:
  1. No portal do Azure, clique no botão Grupos de recursos.
  2. Selecione Adicionar.
  3. Informe os seguintes valores:
    • Inscrição: Selecione sua assinatura do Azure, como o Microsoft Azure Enterprise.
    • Grupo de recursos: Digite um novo nome de grupo de recursos, como resource-group.
    • Região: Selecione sua localização, como Oeste dos EUA.
  4. Clique em Review+create.
  5. Clique em Criar. Leva alguns segundos para criar um grupo de recursos.

Etapa 2: Criar uma conta de armazenamento no Microsoft Azure

Onde: Portal do Microsoft Azure

Uma conta de armazenamento do Azure contém todos os objetos de dados de armazenamento, como blobs, tabelas, discos etc. Você pode criar uma conta de armazenamento dentro do grupo de recursos. Ele fornece um namespace exclusivo para seus dados. Para criar uma conta de armazenamento:

  1. No menu do portal esquerdo, selecione Contas de armazenamento para exibir uma lista de suas contas de armazenamento.
  2. Na página Contas de armazenamento, clique no ícone Criar.
  3. Na guia Básico, forneça as informações a seguir para sua conta de armazenamento.
    • Inscrição: Microsoft Azure Enterprise
    • Grupo de recursos: resource-group
    • Nome da conta de armazenamento: teststorage
    • Região: Selecione sua localização, como Oeste dos EUA.
    • Redundância: Armazenamento localmente redundante (LRS)
  4. Você pode selecionar Review+create para aceitar as opções padrão e continuar a validar a conta.
  5. Depois que a validação passar, você poderá clicar na conta Criar armazenamento. No caso de falha na validação, o portal indica quais definições devem ser modificadas.

Etapa 3: Criar chaves de acesso

Onde: Portal do Microsoft Azure

Conceda ao Microsoft Azure as permissões necessárias para obter chaves de acesso em seus locais de armazenamento. As chaves de acesso específicas da conta de armazenamento são geradas automaticamente após a criação da conta de armazenamento na etapa anterior. As etapas a seguir descrevem o procedimento para criar chaves de acesso.

  1. Em Security+Networking , selecione Chave de acesso. As chaves de acesso da conta aparecem com a string de conexão completa para cada chave.
  2. Selecione Mostrar chaves para mostrar suas chaves de acesso e string de conexão para cada chave e para copiar valores.
  3. Copie o valor da string de conexão em key1. Esse valor será colado no campo de texto Chave de acesso da conta de armazenamento do Azure da próxima etapa ( Etapa 5: Adicionar armazenamento na nuvem usando o armazenamento na nuvem do Microsoft Azure).
  4. Copie o nome da conta de armazenamento, isto é, teststorage, e cole-o no campo de texto Nome da conta de armazenamento do Azure da próxima etapa ( Etapa 5: Adicionar armazenamento na nuvem usando o armazenamento na nuvem do Microsoft Azure).
  5. Teste as credenciais para ver se funcionam ou não.

Etapa 4: Criar um contêiner

Onde: Portal do Microsoft Azure

Um contêiner é um local (também conhecido como buckets no Amazon S3 e no OCI) que mantém o armazenamento do Azure Blob (objeto binário grande). Siga estas etapas para criar um contêiner:

  1. Navegue até sua nova conta de armazenamento no portal do Azure.
  2. No menu esquerdo da conta de armazenamento, role até a seção Armazenamento de dados e selecione Contêineres.
  3. Clique no ícone +Container.
  4. Digite o nome do seu novo contêiner. O nome do contêiner deve ser minúsculo, deve começar com letra ou número e só pode incluir letras, números e o caractere de travessão.
  5. Defina o Nível de Acesso Público como Privado. O nível padrão é Privado.
  6. Selecione Criar para criar o contêiner.

Etapa 5: Adicionar armazenamento na nuvem usando o armazenamento na nuvem do Microsoft Azure

Onde: Database Actions: página Gerenciar Nuvem

  1. Clique no botão Gerenciar Armazenamento na Nuvem na parte superior da página para ir até a página Gerenciar Nuvem. Para obter mais instruções sobre como adicionar arquivos de origem que residem no armazenamento na nuvem fornecido pelo armazenamento na nuvem do Microsoft Azure, consulte o tópico Criar um Link de Armazenamento na Nuvem do Microsoft Azure na seção Gerenciando Conexões.
Observação

Cole o valor da string de conexão na chave 1 da etapa anterior 3: Criar Chaves de Acesso no campo de texto Chave de acesso da conta de armazenamento do Azure da página Adicionar Armazenamento na Nuvem. Cole também o nome da conta de armazenamento gerado na etapa anterior Etapa 3: Criar Chaves de Acesso no campo de texto Nome da conta de armazenamento do Azure da página Adicionar Armazenamento na Nuvem.

Etapa 6: Criar e configurar um feed de tabela ativa para usar notificações e copiar o URL de notificação

Onde: Database Actions: página Live Feeds.

O objeto de feed de tabela ativa permite que os dados sejam carregados do armazenamento na nuvem do Microsoft Azure sem atraso de sondagem. Esse objeto cria uma integração entre o Oracle Cloud Interface e o Microsoft Azure.

Você pode configurar um feed de tabela ativa novo ou existente para usar notificações:

  1. Vá para a página Live Feeds do Database Actions, conforme descrito em Alimentando Dados.
  2. Crie ou edite um objeto de feed de tabela ativa, conforme descrito em Criar um Objeto de Feed de Tabela Ativa ou Edit a Live Table Feed Object. Selecione a opção Ativar para Notificação
  3. Clique em Criar ou Salvar.
  4. Clique no ícone Ações ( três pontos na vertical) no cartão do seu live feed e selecione Mostrar URL de Confirmação.
  5. Na caixa de diálogo URL de Notificação, clique no ícone Copiar para copiar o URL para a área de transferência. Convém copiá-lo para um arquivo temporário, para que você possa recuperá-lo posteriormente. Você usará esse URL na etapa subsequente (Etapa 8: Criar Assinatura de Evento).

Etapa 7: Ativar Provedor de Recursos de Evento

Onde: Portal do Microsoft Azure

Se esta for a primeira vez que você está usando a Grade de Eventos, ative o provedor de recursos dela.

  1. Selecione Inscrições no menu esquerdo.
  2. Selecione a assinatura que você está usando para a Grade de Eventos, isto é, Microsoft Azure Enterprise.
  3. No menu esquerdo, em Definições, selecione Provedores de Recursos.
  4. Pesquise Microsoft.EventGrid.
  5. Selecione Registrar.

Leva um minuto para finalizar o registro.

Etapa 8: Criar Assinatura de Evento

Onde: Portal do Microsoft Azure

Você cria uma Assinatura de Evento configurando a assinatura e especificando o ponto final que receberá as notificações.

  1. Selecione a conta de armazenamento criada na Step 2: Criar uma conta de armazenamento no Microsoft Azure.
  2. Selecione o ícone Eventos no painel de navegação esquerdo.
  3. Clique em +Event Assinatura.

É exibida a janela Criar Assinatura de Evento.

  1. Especifique os seguintes campos na seção de detalhes Inscrição de Evento:
    • Nome: Eventssub. Esse é o nome da Assinatura de Evento que criamos.
    • Esquema de Evento: Esquema da Grade de Eventos
  2. Especifique os seguintes campos na seção Detalhes do Tópico:
    • Tipo de Tópico: Conta de armazenamento
    • Nome do Tópico do Sistema: eventtopic.
  3. Especifique os seguintes campos na seção Tipos de Evento:
    • Tipo de Evento: MicrosoftStorage.BlobCreated
  4. Especifique os seguintes campos na seção Detalhes do Ponto Final:
  5. Selecione Criar.

Dessa forma, o Microsoft Azure cria um tópico do sistema primeiro e depois a Assinatura do Evento para o tópico.

Etapa 9: Confirmar se o ponto final pode receber notificações

Onde: Database Actions: página Live Feeds.

  1. Retorne à página Live Feeds do Database Actions e localize o cartão do feed da tabela ativa que você está configurando para um feed baseado em notificação, conforme criado na Etapa 6: Criar e configurar um feed de tabela ativa para usar notificações e copiar o URL de notificação.
  2. Clique no ícone Ações ( três pontos na vertical) no cartão e selecione Mostrar URL de Confirmação.
  3. Na caixa de diálogo URL de Confirmação, clique no link para confirmar o URL. Isso não fecha essa caixa de diálogo. Se o link for bem-sucedido, será exibida uma mensagem confirmando que a assinatura está ativa.
    Observação

    O link URL de Confirmação expira após alguns minutos. Certifique-se de clicar no link antes que ele expire.
  4. Volte para a caixa de diálogo URL de Confirmação e marque a caixa de seleção Verificar somente quando o processo de confirmação do armazenamento na nuvem estiver concluído e clique em OK.
Depois de concluir as etapas acima, faça upload de um novo arquivo para o contêiner do Microsoft Azure criado na Step 4: Criar um contêiner.
  1. Navegue até o contêiner criado.
  2. Selecione o Contêiner para mostrar uma lista de blobs que ele contém.
  3. Selecione o botão Fazer Upload para abrir seu repositório local e procurar o arquivo que você precisa carregar por upload como blob em bloco.
  4. Selecione o botão Fazer Upload para fazer upload do blob.
  5. Agora você pode exibir o novo blob listado no contêiner.
  6. Volte para a página Live Feeds do Database Actions e localize o cartão do feed de tabela ativa que você está configurando para um feed baseado em notificação.
  7. Clique no ícone Ações ( três pontos na vertical) no cartão e selecione Detalhes da Execução do feed de tabela ativa.

Você deverá poder exibir logs do blob carregado por upload para a tabela de Live Feed do armazenamento do Microsoft Azure na janela Detalhes da Execução do feed de tabela ativa.

Para obter mais detalhes sobre como criar um tópico e uma assinatura no portal do Azure, consulte Notificações da Grade de Eventos do Azure.