Carregamento de Dados da Partição Federada

Num cubo do Essbase de partição federada, pode carregar dados para a sua tabela de factos no Autonomous Data Warehouse. Antes de o fazer, precisa de integrar o Essbase no OCI Object Storage e configurar as credenciais DBMS_CLOUD utilizando o script configure-dbms-writeback.

Integrar o Essbase no OCI Object Storage

Para carregar dados de um cubo de partição federada para a sua tabela de factos no Autonomous Data Warehouse, o Essbase utiliza o pacote DBMS_CLOUD, disponível com Autonomous Database.

Para aceder ao pacote DBMS_CLOUD, deve ter selecionado para integrar o Essbase com OCI Object Storage quando implementou a pilha do Oracle Essbase no Oracle Cloud Marketplace.

Para obter detalhes completos, consulte Implementar o Essbase a partir do Marketplace para Partições Federadas.

Configurar Credenciais para o Carregamento de Dados

Antes de ser possível efetuar qualquer operação de carregamento de dados através do Essbase para o Autonomous Data Warehouse, deve ser concluído um fluxo de trabalho de passos para ativar as credenciais da cloud a utilizar com partições federadas.

Tipos de Utilizador no Fluxo de Trabalho de Credenciais do Carregamento de Dados

Os utilizadores com os seguintes tipos de acesso estão ou podem estar envolvidos no fluxo de trabalho obrigatório para configurar um cubo de partição federada para o carregamento de dados. Na sua organização, estes perfis de grupo podem ser separados (para que a configuração seja um fluxo de trabalho colaborativo) ou os perfis de grupo podem ser combinados (uma pessoa tem todo o acesso necessário).

Tipo de Utilizador	Perfil de Grupo no Fluxo de Trabalho
Utilizador de SSH	Pode utilizar a linha de comandos do sistema operativo para aceder, como utilizador opc, à instância do Essbase implementada no Oracle Cloud Infrastructure. (Pode ser a mesma pessoa que implementou o Essbase como uma pilha no OCI.)
Utilizador da BD	Sabe o nome do schema e a senha do Autonomous Data Warehouse, o mesmo schema e senha que são utilizados para criar a ligação do Essbase ao Oracle Database (um pré-requisito necessário antes de criar a partição federada).
Utilizador do OCI	Pode aceder à Consola do OCI, incluindo ao bucket de armazenamento de objetos para o catálogo do Essbase.
Admin da BD	Sabe o nome do schema e a senha do administrador do Oracle Database.
Admin do Essbase	O administrador do sistema do Essbase. Pode ser o administrador inicial do Essbase criado pelo administrador do domínio da identidade (que também pode ser o Utilizador do OCI) ou pode ser outro administrador do sistema do Essbase criado após a conclusão da implementação do Essbase.
Gestor de Aplicações do Essbase	O gestor/proprietário de uma aplicação do Essbase, criado após a conclusão da implementação do Essbase.

Fluxo de Trabalho de Credenciais do Carregamento de Dados

O seguinte fluxo de trabalho de passos deve ser concluído por cada schema da base de dados que está a utilizar para a partição federada.

Utilizador do OCI: Siga as instruções em Implementar o Essbase a partir do Marketplace para Partições Federadas para implementar o Essbase na tenancy do OCI com as seleções adequadas para partições federadas.
Utilizador da BD, Admin do Essbase ou Gestor de Aplicações do Essbase: Entre em sessão na interface web do Essbase e crie uma ligação ao Autonomous Data Warehouse, conforme descrito em Criar uma Ligação para Partições Federadas.
Utilizador da BD, Admin do Essbase ou Gestor de Aplicações do Essbase: Crie a partição federada, conforme descrito em Criar uma Partição Federada.
Utilizador do OCI: A partir do seu perfil de utilizador na Consola do OCI, gere e copie um token de autenticação. Forneça este elemento, e o seu nome de utilizador, ao Utilizador de SSH.

Consulte Obter um Token de Autenticação.
Utilizador de SSH: Execute o script de preparação do carregamento de dados, disponível na instância do Essbase no OCI. Só precisa de executar o script uma vez por schema da base de dados no Autonomous Data Warehouse.

Exemplo:
1. Mude para o utilizador oracle.
```
sudo su oracle
```
2. Navegue para a localização 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 script com o argumento -h ou --help. Sintaxe: ./configure-dbms-writeback.sh [--help | -h]
  
  Nota:
  Opcionalmente, execute o script com a opção vault. Esta opção define o script para utilizar as credenciais de admin da BD armazenadas no cofre, acedidas através do OCID, em vez de lhe solicitar a senha. Sintaxe: ./configure-dbms-writeback.sh [--vault | -V]
4. Quando lhe for solicitado, introduza as informações obrigatórias:
  - Senha de Admin da BD, se não tiver executado o script com a opção vault. Uma vez que a senha é uma informação protegida, não verá o texto à medida que escreve na linha de comandos.
  - Nome de utilizador e senha do Utilizador da BD. Uma vez que a senha é uma informação protegida, não verá o texto à medida que escreve na linha de comandos.
  - Nome de utilizador e token de autenticação do Utilizador do OCI. Introduza toda a cadeia de caracteres de identificação de utilizador. Para encontrar esta cadeia de caracteres, na Consola do OCI, clique no ícone de perfil no canto superior direito para apresentar uma perspetiva geral do perfil do utilizador. Copie a cadeia de caracteres completa apresentada abaixo de Perfil e acima de Tenancy.
O script cria a credencial da cloud necessária e armazena-a no schema da base de dados. Não é necessário voltar a executar o script quando reiniciar o OCI, o Essbase ou as aplicações do Essbase.

Agora pode carregar dados através do Essbase para atualizar a tabela de factos do Autonomous Data Warehouse.

Nota:

Para o Utilizador de SSH – Se o token de autenticação do utilizador do OCI utilizado no script de preparação do carregamento de dados já não tiver acesso ao bucket de armazenamento de objetos para o catálogo do Essbase, terá de encontrar outro utilizador do OCI que cumpra os requisitos listados em Tipos de Utilizador no Fluxo de Trabalho de Preparação do Carregamento de Dados e repetir os passos do fluxo de trabalho.

Outras Notas sobre Carregamento de Dados da Partição Federada

Localização do Ficheiro de Dados de Origem

Antes de efetuar um carregamento de dados através do Essbase para a tabela de factos, a Oracle recomenda que deve carregar o ficheiro de dados para o Essbase Server. O carregamento de dados do lado do cliente é suportado, mas demora mais tempo.

Ferramentas de Carregamento de Dados que Não São do Essbase

Se não for necessário carregar dados através do Essbase para o Autonomous Data Warehouse, pode utilizar as Ferramentas de Dados no Autonomous Database para carregar os dados para a tabela de factos e executar outras tarefas de gestão. No entanto, certifique-se de que a estrutura do cubo e a tabela de factos não ficam dessincronizadas – consulte Precauções Relativas a Metadados para Cubos de Partições Federadas.

Ficheiros de Dados Formatados de DBMS

Carregar ficheiros de exportação de dados formatados do Essbase para cubos de partição federada pode ser demorado. Para otimizar carregamentos de dados, utilize um ficheiro de origem formatado de DBMS. Pode efetuar um utilizando o comando de cálculo DATAEXPORT com a opção DataExportCSVFormat. Os ficheiros formatos como CSV podem ser carregados mais rápido uma vez que estão em conformidade com as opções de formato do pacote DBMS_CLOUD para ficheiro de origem.

Dimensão de Rotação na Tabela de Factos e Origem de Entrada de Dados de Carregamento de Dados

A dimensão de rotação utilizada nos ficheiros de entrada de dados do carregamento de dados deve ser a mesma que a dimensão de rotação da tabela de factos.

Por exemplo, na seguinte tabela de factos, a dimensão de rotação é a dimensão de Medidas (Sales, COGS, Margin, etc).

A tabela de factos de dados e metadados não normalizados mostrados no SQL Developer, com os cabeçalhos das colunas "Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions" e "Ending Inventory".

Um ficheiro de entrada de dados de carregamento de dados aceitável para esta tabela de factos tem uma forma semelhante, uma vez que tem a mesma dimensão de rotação. 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 de rotação do ficheiro de entrada de dados diferir da dimensão de rotação da tabela de factos, é devolvido um erro e a tarefa de carregamento de dados é terminada.

Importação de Vários Ficheiros em MaxL Não Suportada

A importação de dados de vários ficheiros em paralelo utilizando uma instrução de MaxL import com caracteres de substituição não é suportada para os cubos de partição federada.