Documentação do Oracle Cloud Infrastructure

Dados de Alimentação

Você pode executar um feed de tabela ao vivo 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 seu 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, Delimited TXT. Todos os arquivos devem ter a mesma assinatura de coluna.

Sobre a página do RSS

Na página Painel de Controle do Database Actions - DATA Load, selecione FEED DATA para exibir a página Live FEED. Nesta página, você pode:

Gerenciar Conexões de Armazenamento na Nuvem para Feeds de Tabela Ativos

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

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

Criar um Objeto de Alimentação de Tabela Ativa

Para criar um objeto de alimentação de tabela ativa,
  1. Na página Live Feed, clique no botão + Criar Live Table Feed para exibir o painel Live Feed Settings. Especifique informações na guia Origem de Dados da seguinte forma:

    • Local da Loja na Nuvem: Selecione o Local da Loja na Nuvem na lista suspensa. 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(s) arquivo(s) que você deseja usar para alimentar dados no armazenamento de objetos. Selecione Bucket Inteiro para carregar todos os arquivos do bucket na tabela. As pastas são listadas e organizadas no menu suspenso com base na forma como você cria pastas ou diretórios e armazena seus arquivos. Por exemplo, você pode criar uma pasta de vendas para armazenar os arquivos sales1.csv e sales2.csv.

    • Extensões:

      Informe uma extensão para limitar o feed de tabela ativa somente aos arquivos no bucket que correspondem à extensão. Por exemplo, para limitar os arquivos apenas aos 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 somente aos arquivos no bucket que correspondem ao glob. Por exemplo, para limitar os arquivos apenas aos arquivos CSV, digite *.CSV.

    • Na seção Visualização do arquivo do Live Feed, você pode exibir uma visualização do 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 que exibe.

    • Mesclar na Tabela: Esta opção mescla dados de feed ativo 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.

    • Carregar Coleção: Você pode definir seu feed ao vivo em arquivos JSON com essa opção. Ao selecionar esta opção, você não visualizará 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 informe outro nome. Este é o nome da tabela de destino na qual os dados do feed ativo serão carregados na sua 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 Feed ao Vivo seja carregado. Isso é para maior precisão.

    A guia Definiçõ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. Esta opção está disponível quando o arquivo vinculado está em formato de texto sem formatação (CSV, TSV ou TXT). O tipo de codificação padrão é UTF-8.
    • Anexo de texto: Selecione o caractere para o texto de delimitação: " (caractere de aspas duplas),' (caractere de aspas simples) ou Nenhum. Essa opção só é visível quando o arquivo selecionado está em formato de texto sem formatação (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 nesta lista. O padrão é Vírgula. Essa opção só é visível quando o arquivo selecionado está em formato de texto sem formatação (CSV, TSV ou TXT).
    • Iniciar o 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 Column header row em Source column name (consulte abaixo) e se você informar um número maior que 0 no campo Start processing data at row, esse número de linhas depois da 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 se você 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 das colunas na tabela de origem.

      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. (Também será necessário inserir tipos de dados).

      Marque a caixa de seleção Converter dados inválidos em nulos para converter um valor de coluna numérica inválido em um valor nulo.

      Newlines 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. Você pode visualizar a linha rejeitada no painel Relatório de Cargo.

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

      O conteúdo da tabela Mapeamento é alterado de acordo com a opção de processamento escolhida na seção Tabela e quais propriedades você define 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 Frase ou Extração de Frase de Chave, Detecção de Idioma ou Tradução de Textocom os dados de origem. Consulte Usar Recursos do Serviço OCI Language 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 Configurações do Feed Ativo.

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

    • Nome do Feed da Tabela Ativa: Aceite o nome padrão ou informe outro nome para identificar esse feed da 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 possam ocorrer quando a sondagem é iniciada em uma programação (ou seja, se você tiver selecionado a opção Agendado do feed de tabela ativa).

      Quando você seleciona a opção Ativar para Notificação, 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 de serviço de Eventos
      • Copiar o URL de notificação
      • Criar uma assinatura do serviço Notifications
      • Confirmar se as notificações são permitidas

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

    • Ativar para Programação: Selecione esta opção para configurar uma programação para executar o objeto de alimentação de tabela ativa, ou seja, para sondar a origem de dados regularmente:

      • Nos campos de intervalo de tempo, informe um número e selecione um tipo de tempo e os dias em que o bucket deverá procurar arquivos novos ou alterados. Por exemplo, para pesquisar a cada duas horas na 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 na lista suspensa 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 uma data inicial e uma data final com as horas inicial e final. Se você não selecionar uma data de início, a hora e a data atuais serão usadas como a data de início. A data de término é opcional. No entanto, sem uma data final, o feed ao vivo continuará a sondar.

    Selecione um grupo de consumidores na lista drop-down, ou seja, baixo, médio e alto.

  2. Clique em Criar para criar o objeto do feed 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 do Feed da Tabela Ativa

Quando você abre a página Alimentação Ativa, os objetos de alimentação 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 alimentação 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 alimentação de tabela ativa do esquema do usuário atual são mostrados. Assim que você começar a digitar no campo de pesquisa, a ferramenta de alimentação retornará 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 de pesquisa.

  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 de seu nome.

  3. Para mostrar objetos de todos os esquemas disponíveis, selecione Todos no menu suspenso Esquema.

Para classificar objetos de alimentação de tabela ativa

  1. Clique no botão Classificar por no canto superior direito da página.

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

Localizar e Exibir Objetos do Feed da Tabela Ativa

Para procurar entidades de alimentação de tabela ao vivo disponíveis nos esquemas selecionados, informe um valor no campo de pesquisa na parte superior da página e pressione Enter. Em seguida, a exibição inclui apenas as entidades cujos nomes contêm 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 valor de classificação dos filtros selecionados, desmarque o esquema ou valor de classificação no painel de filtros ou clique no ícone Remover filtro (X) do esquema ou valor de classificação acima da exibição de objetos de alimentação de 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 ao vivo, clique no ícone Atualizar na parte superior da página.

Editar um Objeto de Alimentação de Tabela Ativa

Para editar detalhes de um objeto de alimentação de tabela ativa,
  1. Na página Feed ao Vivo, localize o cartão para o feed de tabela ao vivo 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 da Loja na Nuvem: Selecione o Local da Loja na Nuvem na lista suspensa. 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 na forma como você cria pastas ou diretórios e armazena seus arquivos. Por exemplo, você pode criar uma pasta de vendas para armazenar os arquivos sales1.csv e sales2.csv.

      • Extensões:

        Informe uma extensão para limitar o feed de tabela ativa somente aos arquivos no bucket que correspondem à extensão. Por exemplo, para limitar os arquivos apenas aos 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 somente aos arquivos no bucket que correspondem ao glob. Por exemplo, para limitar os arquivos apenas aos arquivos CSV, digite *.CSV.

    • Na guia Configuraçõ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 atrasos que possam ocorrer quando a sondagem é iniciada em uma programação (ou seja, a opção Programado do feed de tabela ativa).

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

      • Copiar 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.
      • Crie uma assinatura.
      • Confirme se as notificações são permitidas no serviço de feed ao vivo.

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

    • Programado: Selecione esta opção para configurar uma programação para executar o objeto de alimentação de tabela ativa, ou seja, para sondar a origem de dados em bases regulares:

      • Nos campos de intervalo de tempo, informe um número e selecione um tipo de tempo e os dias em que o bucket deverá procurar arquivos novos ou alterados. Por exemplo, para pesquisar a cada duas horas na 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 na lista suspensa 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 uma data inicial e uma data final com as horas inicial e final.

  3. Clique em Salvar.

Executar um Feed de Tabela Ativa

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

Para executar um feed de tabela em tempo real sob demanda:

  1. Na página Feed ao vivo, encontre o cartão para o feed de tabela ao vivo que deseja executar.
  2. Clique no ícone Ações (três pontos) no cartão e selecione Executar Feed da Tabela Ativa Imediatamente (Uma Vez).

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

Você pode definir uma programação para executar feeds de tabela ao vivo no painel Criar Feed de Tabela ao Vivo (ao criar um novo feed de tabela) ou no painel Editar Feed de Tabela ao Vivo (ao editar um feed de tabela existente). Consulte Criar um Objeto de Alimentação de Tabela Ativa ou Editar um Objeto de Alimentação de Tabela Ativa.

Para executar um feed de tabela ativo 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 os detalhes da execução do feed de tabela ativa:

  1. Na página Feed ao Vivo, localize o cartão para o feed de tabela ao vivo 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 da Tabela Ativa.

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

Excluir um feed de tabela ativo

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

Tópico pai: Página Carga de Dados

Criando um Feed de Tabela ao Vivo Baseado em Notificação

Você pode carregar dados por meio de um feed de tabela ao vivo com base em uma notificação do Oracle Cloud Infrastructure.

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

Observação

  • Os feeds de tabela ao vivo baseados em notificação não estão disponíveis no nível gratuito 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 ao vivo baseados em notificação não estão disponíveis nos Oracle Autonomous Data Warehouse Databases (ADW) configurados usando um ponto final privado.

Para criar um feed de tabela ao vivo 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. Você pode achar conveniente abrir a Console do Cloud em uma página ou guia do browser e o Database Actions em outra, por isso é fácil ir e vir.

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

Onde: Console do Oracle Cloud Infrastructure: Página Armazenamento de Objetos e Armazenamento de Arquivos Compactados - 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 defini-lo em um bucket existente.

  1. Abra o menu de navegação da Console do Cloud e clique em Storage. Em Object Storage e Arquivamento, 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, juntamente 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 Emitir Eventos de Objeto.
    3. Marque a caixa de seleção Emitir Eventos de Objetos e clique em Salvar Alterações.

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

Onde: Console do Oracle Cloud Infrastructure: Página Notificações - Tópicos

  1. Abra o menu de navegação da Console de 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 de serviço Events

Onde: Console do Oracle Cloud Infrastructure: Página Eventos - Regras

  1. Abra o menu de navegação da Console do Cloud e clique em Observabilidade & Gerenciamento. Em ServiçoEvents, 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: Armazenamento de Objetos
      • 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: Página Database Actions: Live Feeds

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

  1. Vá para a página Alimentação Ativa do Database Actions, conforme descrito em Dados de Alimentação.
  2. Crie ou edite um objeto de alimentação de tabela ativa, conforme descrito em Criar um Objeto de Alimentação de Tabela Ativa ou Editar um Objeto de Alimentação de Tabela Ativa. Selecione a opção Ativar para Notificação
  3. Clique em Criar ou Salvar.
  4. Clique no ícone Ações (três pontos verticais) no cartão do seu feed ao vivo 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. Você pode querer copiá-lo para um arquivo temporário, para que 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: Página Console do Oracle Cloud Infrastructure: Notificações - Assinaturas

  1. Retorne à 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 Notificações, clique na guia Assinaturas (no lado esquerdo da página), o status será Ativo.
  3. Clique em Criar Inscrição e preencha a página Criar Inscrição:

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

Onde: Página Database Actions: Live Feeds

  1. Retorne à página RSS do Database Actions e localize o cartão para o feed de tabela ativa que você está configurando para um feed baseado em notificação.
  2. Você verá o cartão de alimentação ao vivo em um status Ativo.

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

Consulte Enviar email usando a ferramenta de RSS para obter mais detalhes.

Quando você concluir as etapas acima, todos os novos arquivos carregados no bucket serão carregados automaticamente na tabela de alimentação de tabela ativa.

Tópico principal: Alimentando Dados

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

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

Dica:

Para concluir essas etapas, você precisará alternar entre o 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 navegador e o Database Actions em outra, por isso é fácil ir e vir.

Para criar um feed ao vivo baseado em notificação com o Amazon S3 como armazenamento na nuvem, você deve:

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 login no console do AWS Management e abra o console do Amazon S3.
  2. Na home page, clique no ícone Criar Bucket.
  3. Em Nome do bucket, digite um nome válido para o seu bucket. Por exemplo: testbucket. Depois de criar o bucket, você não poderá alterar seu nome.
  4. Em Região, selecione a Região do Amazon Web Services (AWS) no menu suspenso. Por exemplo: Us-West-2
  5. Nas definições do Bucket para Bloquear Acesso Público, selecione as definições de Bloquear Acesso Público que você deseja aplicar ao bucket. Recomenda-se manter todas as configurações ativadas, a menos que você saiba que precisa desativar qualquer uma delas.
  6. Selecione Configuraçõ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 do AWS Management

Para acessar o Amazon Simple Notification Service (SNS), você deve ter credenciais que o Amazon Web Services (AWS) pode 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 Identity and Access Management (IAM) para fins de segurança.

  1. Faça login no console do AWS Management e abra o console do Amazon Identity and Access Management (IAM).
  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 Download.csv file. Dessa forma, você pode armazenar o arquivo em um local seguro.

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

Onde: Página Database Actions: Manage Cloud

Antes de criar um feed de tabela ao vivo, você deve estabelecer uma conexão com o armazenamento na nuvem que deseja usar.

  1. Clique no botão Gerenciar Loja 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 Secreto 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: Página Database Actions: Live Feeds

A criação de um feed de tabela ativo permite carregar dados em tempo real de origens de armazenamento externo para sua tabela no ADB. O armazenamento externo que você usa inclui como contêineres Oracle Object Store, AWS S3 ou Microsoft Azure.

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

  1. Vá para a página Alimentação Ativa do Database Actions, conforme descrito em Dados de Alimentação.
  2. Crie ou edite um objeto de alimentação de tabela ativa, conforme descrito em Criar um Objeto de Alimentação de Tabela Ativa ou Editar um Objeto de Alimentação de Tabela Ativa. Selecione a opção Ativar para Notificação
  3. Clique em Criar ou Salvar.
  4. Clique no ícone Ações (três pontos verticais) no cartão do seu feed ao vivo 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. Você pode querer copiá-lo para um arquivo temporário, para que 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 de tópico e um tipo de tópico. Depois de criar um tópico, você não pode alterar o tipo ou 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 você deve criar uma conta da AWS.

Navegue até o console do AWS Management e selecione Criar uma Conta do 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 login em qualquer um dos serviços da AWS como usuário do IAM.

  1. Faça log-in na console do Amazon SNS como um 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: notify-topic. Para um tópico FIFO, adicione FIFA 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 ou se inscrever no tópico. Esta etapa é opcional. Edite o formato JSON da política com base nos detalhes do tópico que você informar. 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 nova tentativa de entrega (HTTP/S) para configurar como o Amazon SNS repete as tentativas de entrega de mensagens com falha. Esta etapa é opcional.
  7. Expanda a seção Log de status de 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 Criar tópico.
  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. Copiar o tópico ARN para a área de transferência.

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

Onde: console do Amazon S3 Management

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

  1. Faça login no console do Amazon S3 Management e acesse como um usuário do IAM (Amazon Identity and Access Management).
  2. Na lista Buckets, selecione o nome do bucket, ou seja, testbucket. Esse é o bucket que você criou na Etapa 1: Criar seu bucket de armazenamento de objetos no Amazon S3.
  3. Selecione o ícone Propriedades.
  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: notificação do bucket
    • Prefixo: Esse valor serve para filtrar notificações de evento por prefixo. É um valor opcional. Isso foi adicionado à atividade do evento de filtro.
    • Sufixo: Esse valor serve para filtrar notificações de evento por sufixo. É um valor opcional. Isso foi adicionado à atividade do evento de filtro.
  6. Na seção Tipos de evento, selecione um ou mais tipos de evento para os quais você deseja receber notificações. Se você não tiver certeza de quais tipos de evento escolher, selecione a opção Todos os eventos de criação de objeto.
  7. Na seção Destino, selecione Tópico de SNS como destino de notificação de evento.
    Observação

    Para poder publicar notificações de evento, você deve conceder ao Amazon S3 as permissões necessárias para chamar a API relevante. Isso permite que ele publique notificações em uma função Lambda ou em um tópico do SNS.
  8. Depois de selecionar o tópico SNS como destino de notificação de evento, selecione o tópico SNS, ou seja, o tópico de notificação na lista drop-down. Este é o tópico criado 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 trata da distribuição da mensagem para todos os seus assinantes. Os assinantes podem ser funções do AWS Lambda, endpoints HTTP(S), endereços de email e números de telefone celular capazes de receber mensagens SMS.

O Amazon SNS faz a correspondência do tópico com uma lista de assinantes que se inscreveram nesse tópico e entrega a mensagem a cada um desses assinantes.

  1. Faça logon no console do Amazon SNS.
  2. No painel de navegação esquerdo, selecione Assinaturas.
  3. Selecione Criar assinatura na página de assinaturas.
  4. Na seção Detalhes da página Criar assinatura, 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 Reduzir política (fila de letras mortas) para configurar uma fila de letras mortas para a assinatura. Esta etapa é opcional.
  7. Selecione Criar assinatura.
Observação

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

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

Onde: Página Database Actions: Live Feeds

  1. Retorne à página RSS do Database Actions e localize o cartão para o feed de tabela ativa que você está configurando para um feed baseado em notificação.
  2. Clique no ícone Ações (três pontos verticais) 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. Não fecha esta caixa de diálogo. Se o link for bem-sucedido, será exibida uma mensagem confirmando que a assinatura está ativa.
  4. Retorne à 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.

Quando você concluir as etapas acima, todos os novos arquivos carregados no bucket serão carregados automaticamente na tabela de alimentação de tabela ativa.

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

Tópico principal: Alimentando Dados

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

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

A seção a seguir explica o procedimento para gerar mensagens de feed ao vivo automáticas 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 feed ao vivo no Oracle Cloud Infrastructure.

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

Dica:

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

Etapa 1: Criar um grupo de recursos no Microsoft Azure

Onde: Portal do Microsoft Azure

Os grupos de recursos são contêineres lógicos nos quais você pode gerenciar recursos do Azure, como contas de armazenamento. Grupos de recursos são criados para que você possa implantá-los, atualizá-los e excluí-los como um 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:
    • Assinatura: Selecione sua assinatura do Azure, como o Microsoft Azure Enterprise.
    • Grupo de recursos: Informe um novo nome de grupo do recurso, como grupo-recurso.
    • Região: Selecione sua localização, como oeste dos EUA.
  4. Clique em Revisar + Criar.
  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 seus 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, faça o seguinte:

  1. No menu esquerdo do portal, 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.
    • Assinatura: Microsoft Azure Enterprise
    • Grupo de recursos: grupo de recursos
    • Nome da conta de armazenamento: teststorage
    • Região: Selecione sua localização, como oeste dos EUA.
    • Redundância: Armazenamento redundante local (LRS)
  4. Você pode selecionar Revisar + Criar para aceitar as opções padrão e continuar a validar a conta.
  5. Depois que a validação for aprovada, você poderá clicar em Criar conta de armazenamento. Caso a validação falhe, o portal indica quais definições devem ser modificadas.

Etapa 3: Criar Chaves de Acesso

Onde: Portal do Microsoft Azure

Você deve conceder 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. No Security+Networking , selecione Chaves de acesso. As chaves de acesso da sua conta são exibidas 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 à 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, ou seja, 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 elas 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 na OCI) que contém o armazenamento do Azure Blob (objeto grande binário). Siga estas etapas para criar um recipiente.

  1. Navegue até a 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. Informe o nome do seu novo contêiner. O nome do contêiner deve estar em letras minúsculas, deve começar com uma letra ou um número e pode incluir apenas letras, números e o caractere de traço.
  5. Defina o nível de 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: Página Database Actions: Manage Cloud

  1. Clique no botão Gerenciar Loja 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 em nuvem fornecido pelo armazenamento em nuvem do Microsoft Azure, consulte o tópico Criar um Link de Armazenamento em 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 Etapa 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: Página Database Actions: Live Feeds

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

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

  1. Vá para a página Alimentação Ativa do Database Actions, conforme descrito em Dados de Alimentação.
  2. Crie ou edite um objeto de alimentação de tabela ativa, conforme descrito em Criar um Objeto de Alimentação de Tabela Ativa ou Editar um Objeto de Alimentação de Tabela Ativa. Selecione a opção Ativar para Notificação
  3. Clique em Criar ou Salvar.
  4. Clique no ícone Ações (três pontos verticais) no cartão do seu feed ao vivo 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. Você pode querer copiá-lo para um arquivo temporário, para que possa recuperá-lo posteriormente. Você usará esse URL na etapa subsequente (Etapa 8: Criar assinatura de Evento).

Etapa 7: Ativar Provedor de Recursos do Evento

Onde: Portal do Microsoft Azure

Se esta for a primeira vez que você estiver usando a Grade de eventos, será necessário ativar o provedor de recursos da Grade de eventos.

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

Demora um minuto para a inscrição terminar.

Etapa 8: Criar assinatura do 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 Etapa 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.

A janela Criar Inscrição de Evento é exibida.

  1. Especifique os seguintes campos na seção de detalhes Assinatura do Evento:
    • Nome: Eventssub. Este é o nome da Assinatura do Evento que criamos.
    • Esquema do 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.

Desta forma, o Microsoft Azure cria um tópico do sistema primeiro e, em seguida, a Assinatura do Evento para o tópico.

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

Onde: Página Database Actions: Live Feeds

  1. Retorne à página RSS do Database Actions e localize o cartão para o feed de 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 verticais) 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. Não fecha esta 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. Você deve se certificar de clicar no link antes que ele expire.
  4. Retorne à caixa de diálogo URL de Confirmação e marque a caixa de seleção Verificar somente quando o processo de confirmação da loja virtual estiver concluído e clique em OK.
Depois de concluir as etapas acima, faça upload de um novo arquivo no contêiner do Microsoft Azure que você criou na Etapa 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 fazer upload como um blob em blocos.
  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. Retorne à página RSS do Database Actions e localize o cartão para o feed de tabela ativa que você está configurando para um feed baseado em notificação.
  7. Clique no ícone Ações (três pontos verticais) no cartão e selecione Detalhes da Execução do feed da tabela ativa.

Você deverá ser capaz de exibir logs do blob submetido a upload para a tabela Feed ao Vivo pelo armazenamento do Microsoft Azure na janela Detalhes da Execução do feed de tabela ao vivo.

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.

Tópico principal: Alimentando Dados