Notas sobre o Release

28.6 Importando e Exportando Metadados Utilizando a CWMI (Common Warehouse Metadata Interchange)

28.6.1 Introdução

Além do suporte existente para arquivos de linguagem de tag, o Data Warehouse Center pode agora importar e exportar metadados para e de arquivos XML que estão em conformidade com o padrão Common Warehouse Metamodel (CWM). A importação e a exportação desses arquivos XML em conformidade com o CWM é referida como Common Warehouse Metadata Interchange (CWMI).

Você pode importar e exportar metadados a partir dos seguintes objetos do Data Warehouse Center:

Origens do Warehouse
Destinos do Warehouse
Áreas de assunto, incluindo relações de processos, origens, destinos, etapas e cascatas.
Programas definidos pelo usuário

O utilitário de importação e exportação CWMI não suporta atualmente determinados tipos de metadados, incluindo: planejamentos, esquemas de armazenamento, usuários e grupos.

O Data Warehouse Center cria um arquivo de log que contém os resultados dos processos de importação e exportação. Tipicamente, o arquivo de log é criado no diretório x:\arquivos de programas\sqllib\logging (em que x: é a unidade onde o DB2 foi instalado) ou o diretório que você especificou como a variável de ambiente VWS_LOGGING. O arquivo de log é texto simples, você pode exibi-lo com qualquer editor de textos.

28.6.2 Importando metadados

Você pode importar metadados a partir do Data Warehouse Center ou da linha de comandos.

Os novos objetos que são criados através do processo de importação são atribuídos ao grupo de segurança padrão do Data Warehouse Center. Para obter maiores informações, consulte a seção "Atualizando a segurança após a importação" nesta Notas de Release.

Se estiver importando metadados sobre uma etapa, vários arquivos poderão estar associados à etapa. Os metadados sobre a etapa são armazenados em um arquivo XML, mas às vezes uma etapa tem dados associados armazenados como BLOBs. Os metadados BLOB têm o mesmo nome de arquivo do arquivo XML, mas fica em arquivos separados que têm extensões numeradas. Todos os arquivos de etapas relacionadas devem ficar no mesmo diretório na importação.

Atualizando etapas quando estão no modo de teste ou de produção

Um etapa deve estar no modo de desenvolvimento antes do Data Warehouse Center poder atualizar seus metadados. Se ela estiver no modo de teste ou de produção, rebaixe a etapa para o modo de desenvolvimento antes de importar os metadados:

Efetue logon para o Data Warehouse Center.
Dê um clique com o botão direito do mouse na etapa que deseja rebaixar e clique em Modo.
Clique em Desenvolvimento.

Agora a etapa está no modo de desenvolvimento. Altere a etapa de volta para o modo de teste ou de produção após importar os metadados.

Importando dados a partir do Data Warehouse Center

Você pode importar metadados a partir do Data Warehouse Center:

Efetue logon para o Data Warehouse Center.
No painel esquerdo, clique em Warehouse.
Clique em Selecionado --> Importar metadados --> Arquivo de Intercâmbio...
Na janela Importar metadados, especifique o nome do arquivo que contém os metadados que deseja importar. Você pode digitar o nome do arquivo ou procurar o arquivo.
- Se souber a localização, digite o caminho e o nome do arquivo completos que deseja importar. Certifique-se de incluir a extensão de arquivo .xml para especificar que deseja importar metadados no formato XML ou o arquivo não será processado corretamente.
- Para procurar os arquivos:
  1. Clique no botão de comando reticências (...).
  2. Na janela Arquivo, altere Arquivos do tipo para XML.
  3. Vá para o diretório correto e selecione o arquivo que deseja importar.
    Nota:
    O arquivo deve ter uma extensão .xml.
  4. Clique em OK.
Na janela Importar metadados, clique em OK para finalizar. A janela Progresso é exibida enquanto o Data Warehouse Center importar o arquivo.

Utilizando a linha de comandos para importar metadados

Você também pode usar a linha de comandos para importar metadados. A seguir está a sintaxe do comando de importação:

CWMImport XML_file dwcControlDB dwcUserId dwcPW [PREFIX = DWCtbschema]

XML_file O caminho e o nome do arquivo completos (incluindo a unidade e o diretório) do arquivo XML que deseja importar. Esse parâmetro é obrigatório.
dwcControlDB O nome do warehouse control database para o qual deseja importar os metadados. Este parâmetro é necessário.
dwcUserId O ID do usuário utilizado para se conectar ao banco de dados de controle do armazém. Esse parâmetro é obrigatório.
dwcPW A senha de usuário utilizada para se conectar ao banco de dados de controle do armazém. Este parâmetro é necessário.
[PREFIX=DWCtbschema] O nome do esquema de banco de dados para as tabelas de sistema do Data Warehouse Center. Se nenhum valor for especificado para PREFIX=, o nome do esquema padrão será IWH. Esse parâmetro é opcional.

28.6.3 Atualizando os metadados Após Executar o Utilitário de Importação

Atualizando a segurança após a importação

Como uma medida de segurança, o Data Warehouse Center não importa ou exporta senhas. Você precisa atualizar as senhas nos novos objetos, conforme necessário. Para obter maiores detalhes sobre considerações de importação, consulte a publicação Data Warehouse Center Administration Guide, Capítulo 12, "Exportando e importando metadados do Data Warehouse Center."

Ao importar metadados, todos os objetos serão atribuídos ao grupo de segurança padrão. Você pode alterar os grupos que têm acesso ao objeto:

Efetue logon para o Data Warehouse Center.
Dê um clique com o botão direito do mouse na pasta que contém o objeto que deseja alterar.
Clique em Propriedades e, em seguida, na guia Segurança.
Remova grupos da lista Grupos de warehouse selecionados ou inclua grupos da lista Grupos de warehouse disponíveis.
Clique em OK.

28.6.4 Exportando metadados

Você pode exportar metadados a partir do Data Warehouse Center ou da linha de comandos.

Algumas etapas têm metadados que estão armazenados como BLOB. Um metadados BLOB é exportado para um arquivo separados que tem o mesmo nome de arquivo do arquivo XML da etapa, mas com uma extensão numerada (.1, .2 e assim por diante).

Exportando dados a partir do Data Warehouse Center

Você pode exportar metadados a partir do Data Warehouse Center:

Efetue logon para o Data Warehouse Center.
No painel esquerdo, clique em Warehouse.
Clique em Selecionado --> Exportar metadados--> Arquivo de intercâmbio.
Na janela Exportar metadados, especifique o nome do arquivo que conterá os metadados exportados. Você pode digitar o nome do arquivo ou procurar o arquivo:
- Se souber o caminho e o nome do arquivo completos que deseja usar, digite-o no campo de entrada Nome do arquivo. Certifique-se de incluir a extensão de arquivo .xml para especificar que deseja exportar metadados no formato XML.
- Para procurar os arquivos:
  1. Clique no botão de comando reticências (...).
  2. Na janela Arquivo, altere Arquivos do tipo para XML.
  3. Vá para o diretório correto e selecione o arquivo que deseja que contenha os metadados exportados.
    Nota:
    Qualquer arquivo existente selecionado será sobreposto pelo metadados exportado.
  4. Clique em OK.
Quando a janela Exportar metadados exibir o nome do arquivo correto, clique no objeto na lista Objetos disponíveis cujos metadados deseja exportar.
Clique no sinal > para mover o objeto selecionado da lista Objetos disponíveis para a lista Objetos selecionados. Repita esse processo até todos os objetos que deseja exportar constarem na lista Objetos selecionados.
Clique em OK.

O Data Warehouse Center cria um arquivo de entrada, que contém informações sobre os objetos do Data Warehouse Center selecionados para exportação e, então, exporta os metadados sobre esses objetos. A janela Progresso é exibida enquanto o Data Warehouse Center está exportando os metadados.

Utilizando a linha de comandos para exportar metadados

Antes de exportar metadados a partir da linha de comandos, crie primeiro um arquivo de entrada. O arquivo de entrada é um arquivo de texto com uma extensão .INP e lista todos os objetos pelo tipo de objeto que deseja exportar. Quando você exporta a partir do Data Warehouse Center, o arquivo de entrada é criado automaticamente, mas para exportar a partir da linha de comandos é necessário primeiro criar o arquivo de entrada. Você pode criar o arquivo de entrada com qualquer editor de texto. Digite todos os nomes de objetos conforme aparecem no Data Warehouse Center. Verifique se criou o arquivo em um diretório de leitura/gravação. Quando você executar o utilitário de exportação, o Data Warehouse Center gravará os arquivos XML no mesmo diretório onde está localizado o arquivo de entrada.

A seguir há um arquivo de entrada de amostra:

<PROC>
Tutorial Fact Table Process
<IR>
Tutorial file source
Tutorial target
<UDP>
New Program group

Na seção <PROC> (processos), liste todos os processos que deseja exportar. Na seção <IR> (recursos de informação), liste todas as origens e destinos do warehouse que deseja exportar. O Data Warehouse Center inclui automaticamente as tabelas e colunas que estão associadas a essas origens e destinos. Na seção <UDP> (programas definidos pelo usuário), liste todos os grupos de programas que deseja exportar.

Para exportar metadados, digite o seguinte comando em um prompt de comandos do DOS:

CWMExport INPcontrol_file dwcControlDB dwcUserID dwcPW [PREFIX=DWCtbschema]

INPcontrol_file O caminho e o nome do arquivo completos (incluindo a unidade e o diretório) do arquivo .INP que contém os objetos que deseja exportar. Este parâmetro é necessário.
dwcControlDB O nome do warehouse control database a partir do qual deseja exportar. Esse parâmetro é obrigatório.
dwcUserID O ID do usuário utilizado para se conectar ao banco de dados de controle do armazém. Esse parâmetro é obrigatório.
dwcPW A senha utilizada para se conectar ao banco de dados de controle do armazém. Esse parâmetro é obrigatório.
[PREFIX=DWCtbschema] O nome do esquema de banco de dados para as tabelas de sistema do Data Warehouse Center. Se nenhum valor for especificado para PREFIX=, o valor padrão será IWH. Esse parâmetro é opcional.

[ Início da Página | Página Anterior | Próxima Página | Índice | Índice Remissivo ]

`XML_file`	O caminho e o nome do arquivo completos (incluindo a unidade e o diretório) do arquivo XML que deseja importar. Esse parâmetro é obrigatório.
`dwcControlDB`	O nome do warehouse control database para o qual deseja importar os metadados. Este parâmetro é necessário.
`dwcUserId`	O ID do usuário utilizado para se conectar ao banco de dados de controle do armazém. Esse parâmetro é obrigatório.
`dwcPW`	A senha de usuário utilizada para se conectar ao banco de dados de controle do armazém. Este parâmetro é necessário.
`[PREFIX=DWCtbschema]`	O nome do esquema de banco de dados para as tabelas de sistema do Data Warehouse Center. Se nenhum valor for especificado para `PREFIX=`, o nome do esquema padrão será IWH. Esse parâmetro é opcional.

`INPcontrol_file`	O caminho e o nome do arquivo completos (incluindo a unidade e o diretório) do arquivo `.INP` que contém os objetos que deseja exportar. Este parâmetro é necessário.
`dwcControlDB`	O nome do warehouse control database a partir do qual deseja exportar. Esse parâmetro é obrigatório.
`dwcUserID`	O ID do usuário utilizado para se conectar ao banco de dados de controle do armazém. Esse parâmetro é obrigatório.
`dwcPW`	A senha utilizada para se conectar ao banco de dados de controle do armazém. Esse parâmetro é obrigatório.
`[PREFIX=DWCtbschema]`	O nome do esquema de banco de dados para as tabelas de sistema do Data Warehouse Center. Se nenhum valor for especificado para `PREFIX=`, o valor padrão será IWH. Esse parâmetro é opcional.