Carga de Dados da Partição Federada

Em um cubo de partição federada do Essbase, você pode carregar dados na sua tabela de fatos no Autonomous Data Warehouse. Para poder fazer isso, integre o Essbase com o armazenamento de objetos do OCI e configure as credenciais DBMS_CLOUD usando o script configure-dbms-writeback.

Integrar o Essbase com o OCI Object Storage

Para carregar dados de um cubo de partição federada para uma tabela de fatos no Autonomous Data Warehouse, o Essbase usa o pacote DBMS_CLOUD, disponível com o Autonomous Database.

Para acessar o pacote DBMS_CLOUD, você deve ter selecionado a integração do Essbase com o OCI Object Storage quando implantou a pilha do Oracle Essbase usando o Oracle Cloud Marketplace.

Para obter detalhes completos, consulte Implantar o Essbase pelo Marketplace para Partições Federadas.

Configurar Credenciais para Carga de Dados

Para que qualquer operação de carga de dados possa ser executada pelo Essbase no Autonomous Data Warehouse, um workflow de etapas deve ser concluído para permitir que credenciais de nuvem possam ser utilizadas com partições federadas.

Tipos de Usuário no Workflow de Credenciais de Carga de Dados

Os usuários com os tipos de acesso a seguir estão ou podem estar envolvidos no workflow obrigatório para configurar um cubo de partição federada para carga de dados. Na sua organização, essas atribuições podem ser distintas (de modo que a configuração é um workflow colaborativo) ou as atribuições podem ser combinadas (uma pessoa tem todo o acesso necessário).

Tipo de Usuário	Atribuição no Workflow
Usuário SSH	Pode usar a linha de comando do sistema operacional para acessar, como usuário opc, a instância do Essbase implantada no Oracle Cloud Infrastructure. (Pode ser a mesma pessoa que implantou o Essbase como pilha no OCI).
Usuário do Banco de Dados	Sabe o nome do esquema e a senha do Autonomous Data Warehouse -- o mesmo esquema e senha usados para criar a conexão do Essbase com o Oracle Database (um pré-requisito obrigatório antes de criar a partição federada).
Usuário do OCI	Pode acessar a Console do OCI, incluindo o bucket de armazenamento de objetos para o catálogo do Essbase.
Administrador de Banco de Dados	Sabe o nome do esquema e a senha do administrador do Oracle Database.
Administrador do Essbase	O administrador de sistema do Essbase. Pode ser o administrador inicial do Essbase criado pelo administrador de domínio de identidades (que pode também ser o Usuário do OCI) ou pode ser outro administrador de sistema do Essbase criado após a conclusão da implantação do Essbase.
Gerente de Aplicativos do Essbase	O gerente/proprietário de um aplicativo do Essbase, criado após a conclusão da implantação do Essbase.

Workflow de Credenciais de Carga de Dados

O workflow das etapas a seguir deve ser concluído por cada esquema de banco de dados que você está usando para partição federada.

Usuário do OCI: Siga as instruções em Implantar o Essbase pelo Marketplace para Partições Federadas para implantar o Essbase na tenancy do OCI com as seleções apropriadas para partições federadas.
Usuário do Banco de Dados, Administrador do Essbase ou Gerente de Aplicativos do Essbase: Faça log-in na interface Web do Essbase e crie uma conexão com o Autonomous Data Warehouse, conforme descrito em Criar uma Conexão para Partições Federadas.
Usuário do Banco de Dados, Administrador do Essbase ou Gerente de Aplicativos do Essbase: Crie a partição federada, conforme descrito em Criar uma Partição Federada.
Usuário do OCI: Em seu perfil de usuário na Console do OCI, gere e copie um token de autenticação. Forneça isso, e seu nome de usuário, ao Usuário SSH.

Consulte Obtendo um Token de Autenticação.
Usuário SSH: Execute o script de preparação de carga de dados, disponível na instância do Essbase no OCI. Você só precisa executar o script uma vez por esquema de banco de dados no Autonomous Data Warehouse.

Exemplo:
1. Alterne para o usuário oracle.
```
sudo su oracle
```
2. Navegue até o local do script.
```
cd /u01/vmtools/config/adwwb_dbms
```
3. Execute o script.
```
./configure-dbms-writeback.sh
```
  Nota:
  Para ver as opções do script, execute-o com o argumento -h ou --help. Sintaxe: ./configure-dbms-writeback.sh [--help | -h]
  
  Nota:
  Se preferir, execute o script com a opção de vault. Essa opção define o script para extrair as credenciais de administrador de banco de dados armazenadas no vault, acessadas com o uso do OCID, em vez de solicitar que você informe a senha. Sintaxe: ./configure-dbms-writeback.sh [--vault | -V]
4. Quando solicitado, digite as informações exigidas:
  - Senha do Administrador de Banco de Dados, se você não tiver executado o script com a opção de vault. Como a senha é uma informação protegida, você não verá o texto enquanto digita no prompt de comando.
  - Nome de usuário e senha do Usuário do Banco de Dados. Como a senha é uma informação protegida, você não verá o texto enquanto digita no prompt de comando.
  - Nome de usuário e token de autenticação do Usuário do OCI. Digite a string de identificação completa do usuário. Para encontrar essa string, na Console do OCI, clique no ícone de perfil no canto superior direito para exibir uma visão geral do perfil do usuário. Copie a string completa exibida abaixo de Perfil e acima de Tenancy.
O script cria a credencial de nuvem necessária e a armazena no esquema de banco de dados. Não há necessidade de executar novamente o script ao reiniciar o OCI, o Essbase ou os aplicativos do Essbase.

Agora você pode carregar dados usando o Essbase para atualizar a tabela de fatos do Autonomous Data Warehouse.

Nota:

Para Usuário SSH – Se o token de autenticação do usuário do OCI utilizado no script de preparação de carga de dados não tiver mais acesso ao bucket de armazenamento de objetos para o catálogo do Essbase, você precisará encontrar outro usuário do OCI que atenda aos requisitos listados em Tipos de Usuário no Workflow de Preparação de Carga de Dados e repetir as etapas no workflow.

Outras Observações sobre Carga de Dados de Partição Federada

Localização do Arquivo de Dados da Origem

Antes de executar uma carga de dados por meio do Essbase para a tabela de fatos, a Oracle recomenda fazer upload do arquivo de dados para o Essbase Server. Há suporte para carga de dados no cliente, mas leva mais tempo.

Ferramentas de Carga de Dados Não Essbase

Caso não precise carregar dados por meio do Essbase para o Autonomous Data Warehouse, você poderá usar Ferramentas de Dados no Autonomous Database para carregar dados na tabela de fatos e executar outras tarefas de gerenciamento. No entanto, certifique-se de que o outline do cubo e a tabela de fatos não estejam fora de sincronização – consulte Precauções de Metadados para Cubos de Partições Federadas.

Arquivos de Dados Formatados do DBMS

A tarefa de carregar arquivos de exportação de dados formatados pelo Essbase em cubos de partição federada pode consumir tempo. Para otimizar as cargas de dados, use um arquivo de origem formatado pelo DBMS. Você pode criar um usando o comando de cálculo DATAEXPORT com a opção DataExportCSVFormat. Os arquivos CSV formatados podem ser carregados de forma mais rápida porque estão de acordo com as opções de formato de pacote DBMS_CLOUD para arquivos de origem.

Dimensão Dinâmica na Tabela de Fatos e Origem de Entrada da Carga de Dados

A dimensão dinâmica usada nos arquivos de entrada da carga de dados deve ser a mesma da tabela de fatos.

Por exemplo, na tabela de fatos a seguir, a dimensão dinâmica é Medidas (Vendas, COGS, Margem etc.).

Tabela de fatos de dados e metadados desnormalizados, mostrados no SQL Developer, com os cabeçalhos de colunas "Ano","Produto","Mercado","Cenário","Vendas","COGS","Margem","Marketing","Folha de Pagamento","Diversos","Total de Despesas","Lucro","Abrindo Inventário","Adições" e "Finalizando Inventário"

Um arquivo de entrada da carga de dados aceitável para essa tabela de fatos tem uma forma semelhante, por ter a mesma dimensão dinâmica. Exemplo (truncado):

"Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions","Ending Inventory"
"Jan","100-10","New York","Actual",678,271,407,94,51,0,145,262,2101,644,2067
"Feb","100-10","New York","Actual",645,258,387,90,51,1,142,245,2067,619,2041
"Mar","100-10","New York","Actual",675,270,405,94,51,1,146,259,2041,742,2108

Se a dimensão dinâmica do arquivo de entrada for diferente da dimensão dinâmica da tabela de fatos, um erro será retornado e o job de carga de dados será finalizado.

Não há suporte para diversos Arquivos de Importação no MaxL

Não há suporte para a importação de dados de diversos arquivos em paralelo usando uma instrução MaxL import com caracteres curinga nos cubos de partição federada.