Auxílio do assistente de administração do XML Extender
Conectando-se ao banco de dados
Usando a Barra de Lançamento da Administração do XML Extender
Campos e controlesTarefas
Ativando ou desativando um banco de dados
Tarefa: Habilitando um banco de dados
Tarefa: Desabilitando um banco de dados
Importando os DTDs
Campos e controles
Tarefa: Importando um DTD
Trabalhando com arquivos DAD
Campos e controles
Especificar um DAD - primeira etapa para todos os tipos
Selecionar validação - etapa 2 para todos os tipos
Tabelas laterais- etapa 3 para a coluna do tipo XML
Especificar o texto - etapa 3 para o mapeamento SQL ou para o tipo de mapeamento de nó RDB
Especificar a instrução SQL - etapa 4 para o tipo de mapeamento SQL
Mapear SQL - etapa 5 para o tipo de mapeamento SQL
Mapear nós RDB - etapa 4 para o tipo de mapeamento de nó RDB
Salvar um DAD - última etapa para todos os tipos
Tarefas
Criando ou editando um DAD para colunas XML
Criando ou editando um DAD para coleções XML
Trabalhando com colunas XML
Campos e controles
Selecionar uma tarefa (para colunas)
Incluir uma coluna XML
Habilitar uma coluna XML
Desabilitar uma coluna XML
Tarefas
Incluindo uma coluna XML
Habilitando uma coluna XML
Desabilitando uma coluna XML
Trabalhando com coleções XML
Campos e controles
Selecionar uma tarefa (para coleções)
Habilitar uma coleção XML
Desabilitar uma coleção XML
Tarefas
Ativando uma coleção XML
Desativando uma coleção XML
Com este assistente, é possível conectar-se com o banco de dados que contém ou
vai conter dados XML.
- Endereço
- Digite o nome do banco de dados JDBC a ser conectado ou
selecione um endereço da lista. O assistente executa tarefas em
tempo real nesse banco de dados. Quando se seleciona um endereço da lista, são exibidas a ID
de usuário e o último controlador JDBC associado a ele.
Este campo
é obrigatório.
O endereço possui a seguinte sintaxe:
|Para configurações independentes (recomendado):
jdbc:db2:nome_banco_de_dados
Onde:
- nome_banco_de_dados
- Banco de dados com o qual os documentos XML serão
conectados e armazenados.
Exemplo:
jdbc:db2:sales_db
Para configurações da rede:
jdbc:db2://|servidor:número_da_porta/nome_do_banco_de_dados
Onde:
- |servidor
- |É o nome do servidor onde o XML Extender está situado.
- número_porta
- O número da porta usado para conectar-se com o servidor. Para determinar o
número da porta, digite o seguinte comando a partir da linha de comando do DB2
na máquina do servidor:
db2jstrt port#
- nome_banco_de_dados
- Banco de dados com o qual os documentos XML serão
conectados e armazenados.
Exemplo:
jdbc:db2://host1.ibm.com/sales_db
- ID de Usuário
- Digite ou confirme a ID de
usuário utilizada para acessar o banco de dados. Este campo
é obrigatório.
- Senha
- Digite sua senha para acessar o banco de dados. Este campo
é obrigatório.
- Controlador JDBC
- Digite ou verifique a localização do controlador para o banco de dados.
Este campo
é obrigatório.
O controlador deve ter um dos valores a seguir:
|Para configurações independentes (padrão):
COM.ibm.db2.jdbc.app.DB2Driver
Para configurações da rede:
COM.ibm.db2.jdbc.net.DB2Driver
- Encerrar
- Completa o processo de efetuar logon num banco de dados e
abre a Barra de lançamento.
- Cancelar
- Cancela o assistente.
Quando o Assistente de Administração do XML Extender é iniciado, a
janela Logon é aberta e você se conecta com um banco de dados.
- No campo Endereço, digite o endereço JDBC completo da
origem de dados do IBM DB2 UDB com a qual a conexão está sendo
estabelecida.
- Nos campos ID de Usuário e Senha, digite ou
confirme a ID de usuário e senha do DB2 relativas ao banco de dados
com o qual a conexão está sendo estabelecida.
- No campo Controlador JDBC, digite ou confirme o nome do
controlador JDBC relativo ao endereço especificado.
- Clique em Finalizar para conectar-se ao banco de dados e
avançar para a Barra de Lançamento.
- Na Barra de Lançamento, clique em Alternar Banco de Dados.
- No campo Endereço, digite o endereço JDBC completo da
origem de dados do IBM DB2 UDB com a qual a conexão está sendo
estabelecida.
- Nos campos ID de Usuário e Senha, digite ou
confirme a ID de usuário e senha do DB2 relativas ao banco de dados
com o qual a conexão está sendo estabelecida.
- No campo Controlador JDBC, digite ou confirme o nome do
controlador JDBC relativo ao endereço especificado.
- Clique em Finalizar para conectar-se ao novo banco de
dados e voltar para a Barra de Lançamento. O XML Extender vai desconectá-lo do
banco de dados original e conectá-lo com o novo banco de dados.
A Barra de Lançamento do Assistente de Administração do XML Extender
(a Barra de Lançamento), oferece acesso aos assistentes que
auxiliam na conclusão de tarefas administrativas, como ativar um banco
de dados, editar um arquivo de definição de acesso de dados (DAD) e
ativar colunas ou coleções XML. Selecione o nome da tarefa para lançar o assistente correspondente a ela.
- Alternar Banco de Dados
- Abre a janela onde se efetua o logon num banco de dados
específico. Para armazenar ou acessar documentos XML, é preciso estar
conectado a um banco de dados.
Após efetuar logon em um banco de dados, você pode alternar para outro
banco de dados na Barra de Lançamento.
- Habilitar/Desabilitar Banco de Dados
- Habilita ou desabilita banco de dados do XML Extender. Trata-se de
um botão comutador, que muda em função de o banco de dados estar ou
não habilitado.
Para habilitar o banco de dados, o XML Extender cria UDTs e UDFs do
XML Extender, uma tabela de referência DTD para armazenar DTDs e
informações de cada DTD, além de uma tabela de utilização para
armazenar informações comuns de cada coluna habilitada. Para desabilitar
um banco de dados, o XML Extender elimina UDTs, UDFs, a tabela de
referência DTD e a tabela de utilização do XML. É preciso desabilitar
todas as colunas e coleções do XML antes de tentar desabilitar um banco de
dados.
- Importar um DTD
- Abre a janela Importar DTD para importar um arquivo
de Definição de Tipo de Documento (Document Type Definition - DTD) que já exista para o
repositório DTD do atual banco de dados.
O DTD permite validar dados XML de uma coluna ou coleção XML. É
opcional para dados de coluna XML, mas obrigatório para dados de
coleção XML.
|
- |Editar DAD
- |Abre a janela Especificar um DAD para editar um Acesso a Documento existente.
|Arquivo de definição (DAD) ou criação de um novo DAD. O DAD define como dados
|XML são coletados e armazenados no DB2; ele permite definir os
|atributos e elementos chave de seus dados para que possam ser pesquisados.
|O DAD de coluna XML mapeia a coluna XML nas tabelas laterais para indexação. O
|DAD de coleção XML mapeia dados DB2 na estrutura do documento XML.
- Trabalhar com Colunas XML
- |Abre uma janela para incluir uma coluna XML, ativando uma coluna XML, ou
|desativando uma coluna XML em uma tabela. Para ativar e acessar dados
XML,|ativar uma coluna DB2 para tipos de dados XML.
- Trabalhar com Coleções XML
- Abre uma janela que permite habilitar ou desabilitar uma coleção
XML num banco de dados. Na coleção, para armazenar e acessar dados
XML, usa-se um conjunto de tabelas relacionais.
A partir da Barra de Lançamento, é possível completar as seguintes tarefas do
XML Extender:
Com este assistente, é possível habilitar ou desabilitar um banco de
dados. Habilitar um banco de dados cria UDTs, UDFs, procedimentos
armazenados e tabelas de suporte para a administração, necessários quando
o XML Extender é utilizado. É preciso habilitar o banco de dados para
armazenar, compor ou decompor documentos XML no banco de dados. Desabilitar o banco de dados elimina os UDTs, UDFs, procedimentos
armazenados e tabelas de suporte para a administração.
Clique em Ativar banco de dados na Barra de Lançamento para
ativar o banco de dados atual. Se um banco de dados já estiver ativado, Desativar
Banco de Dados estará disponível.
Depois de ativar o banco de dados, retorna-se para a Barra de
Lançamento.
Clique em Desativar banco de dados na Barra de Lançamento para
desativar o banco de dados atual. Se um banco de dados não estiver ativado, Ativar Banco
de Dados estará disponível.
Depois de desativar o banco de dados, retorna-se para a Barra de Lançamento.
Neste assistente, é possível importar um DTD para validar um
documento XML que está armazenado numa coluna XML ou que esteja sendo
composto a partir de dados do DB2 numa coleção XML.
- Nome do arquivo DTD
- Digite o nome do arquivo DTD ou clique em ... para
navegar por uma lista de DTDs disponíveis. Este campo
é obrigatório.
- ID do DTD
- Digite o nome da ID do DTD. A ID associa o DTD ao DAD do
documento XML e especifica sua localização. A ID do DTD é um identificador do DTD e pode ser o caminho que
especifica a localização do DTD no sistema local. A ID do DTD deve corresponder ao valor especificado no
arquivo DAD para o elemento <DTDID>. Este campo
é obrigatório.
- Autor
- Digite o nome do autor do DTD. O nome aparece automaticamente
se estiver especificado no repositório do DTD. Este campo é
opcional.
- Encerrar
- Insere o DTD no repositório do DTD e retorna para a Barra de
Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Clique em Importar um DTD a partir da Barra de Lançamento para
importar um arquivo DTD existente para o repositório do
DTD do banco de dados atual. Aparece o assistente Importar um DTD.
- Digite o nome do arquivo DTD no campo Nome do arquivo
DTD ou clique em ... para procurar um arquivo DTD que já
exista.
- Digite a ID do DTD no campo ID do DTD.
- Opcionalmente, digite o nome do autor do DTD no campo
Autor.
O XML Extender exibe automaticamente o nome do autor se ele
estiver especificado no DTD.
- Clique em Encerrar para inserir o DTD na tabela de
repositório do DTD, DB2XML.DTD_REF, e retornar para a Barra de Lançamento.
Com este assistente, é possível criar ou editar arquivos DAD para
definir como os documentos XML são usados com o DB2. Arquivos DAD são
usados para:
- Armazenar os documentos XML em colunas e definir tabelas laterais,
que são indexadas para favorecer uma pesquisa estrutural rápida.
- Compor documentos XML a partir de uma ou mais tabelas DB2 definidas
numa coleção XML.
- Decompor documentos XML em uma ou mais tabelas do DB2 definidas
numa coleção XML.
Consulte o DB2 XML Extender Administration and
Programming para saber mais sobre estas técnicas.
- Nome do arquivo
- Digite o nome de um arquivo DAD que já exista ou clique em
... para procurá-lo. Ao criar um DAD novo, deixe o campo em
branco. Se o arquivo DAD existir, seu tipo será exibido em
Tipo, e Próximo estará selecionável.
- Tipo
- Se você está criando um novo DAD, selecione um dos seguintes
tipos de arquivos DAD:
- Coluna XML para especificar como os documentos armazenados
numa coluna deverão ser indexados
- Mapeamento SQL de coleção XML para fazer mapeamento entre
dados relacionais e documentos XML através de uma única instrução SQL
- Mapeamento RDB_node de coleção XML para fornecer definições de
nós para tabelas, colunas e condições que definem como os dados
XML são armazenados
- Próximo
- Vai para a etapa seguinte: Selecione a
validação.
- Encerrar
- Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui o
processo e retorna para a Barra de Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Validar documentos XML com o DTD
- Selecione para validar os documentos XML. Com documentos
válidos, podem ser feitas pesquisas estruturadas nos seus dados. Seus
documentos são validados contra o DTD especificado no arquivo DAD. É
preciso validar os dados XML antes de inserir dados no DB2, porque não
é possível validar dados já inseridos no DB2.
- ID do DTD
- Digite o nome do DTD ou selecione-o na lista de DTDs que já
existem. Quem não importou DTDs para o repositório DTD relativo ao seu
banco de dados não poderá validar seus documentos XML.
- |NÃO validar
- Selecione para continuar sem validar seus documentos XML.
- Voltar
- Vai para etapa anterior: Especificar uma janela DAD.
- Próximo
- Vai para a próxima etapa. Abre a janela Gerenciar tabelas
laterais quando estiver trabalhando com colunas XML, a janela Especificar
instrução SQL quando estiver trabalhando com mapeamento SQL de coleção XML ou
a janela Especificar texto quando estiver trabalhando com mapeamento RDB_node
de coleção XML.
- Encerrar
- Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui
o processo e retorna para a Barra de Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- |Lista de tabelas e colunas existentes
- |Esta tabela contém uma lista de tabelas laterais que devem ser criadas quando uma
|coluna XML que usa este arquivo DAD for criada.. É possível selecionar o
|nome de uma tabela ou coluna existente que deseja alterar ou
|digitar um novo nome nos campos abaixo.
- Nome da tabela
- Digite o nome de uma tabela lateral nova que contenha a
coluna. Se a coluna tiver sido selecionada na lista, aparecerá o nome
de sua tabela para ser modificado. Este campo
é obrigatório.
Exemplo:
ORDER_SIDE_TAB
- Nome da coluna
- Digite o nome da coluna. Se você selecionou um nome a partir da
lista de colunas, o nome da coluna aparece para você modificar. Este campo
é obrigatório.
Exemplo:
CUSTOMER_NAME
- Tipo
- Selecione ou altere o tipo da coluna, tais como DATE, CHAR, INTEGER ou
VARCHAR. Este campo
é obrigatório.
- Comprimento
- Se tiver sido selecionado VARCHAR,
digite ou mude o número máximo de caracteres relativo ao comprimento
da coluna. Este campo só fica habilitado quando o tipo é
VARCHAR.
Exemplo:
30
- Caminho
- Digite ou altere o caminho de localização de um elemento ou atributo. Este campo
é obrigatório.
Exemplo:
/ORDER/CUSTOMER/NAME
- Ocorrência múltipla
- Selecione esta caixa de seleção para indicar se o elemento ou
atributo da coluna pode ser usado mais de uma vez ou apenas uma vez
em um documento. Selecione a caixa correspondente para a ocorrência
múltipla; não a selecione se quiser indicar o contrário.
- Incluir
- Salva a tabela ou a coluna com os detalhes especificados e
permite continuar a incluir, modificar ou excluir uma tabela ou
coluna.
- Alterar
- Salva as alterações efetuadas nos campos Nome da tabela, Nome da
coluna, Tipo, Comprimento, Caminho ou Ocorrência múltipla. Quando
você muda o nome de uma tabela ou coluna, o objeto antigo é eliminado
da lista e o novo é nela incluído.
- Remover
- Remove da lista o item em destaque.
- Voltar
- Vai para a etapa anterior: Selecionar Validação.
- Próximo
- Vai para próxima etapa: Salvar um DAD.
- Encerrar
- Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui
o processo e retorna para a Barra de Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Prólogo
- Digite o nome de um prólogo. Quando se edita um DAD que já
existe, o nome é exibido. O nome deve estar no formato
<?xml versão="1.0" ?>
Este campo
é obrigatório.
- Tipodoc
- Digite o tipo de documento XML. Se estiver editando um DAD existente,
o tipo do documento é exibido. Este campo
é obrigatório.
Exemplo:
<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
- Voltar
- Vai para a etapa anterior: Selecionar Validação.
- Próximo
- Vai para a etapa seguinte: Mapear nós RDB, se o tipo for
mapeamento de nós RDB, ou para Especificar instrução SQL, se o tipo for
mapeamento SQL
- Encerrar
- Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui
o processo e retorna para a Barra de Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Instrução SQL
- Digite uma instrução SQL SELECT. Quando um DAD existente é
editado, a instrução SQL será exibida. A instrução mapeia as colunas da
cláusula SELECT para os elementos ou atributos XML do documento XML.
A cláusula FROM define as tabelas que contêm os dados. A cláusula
WHERE indica as condições da união e da pesquisa. Todas as tabelas da
coleção têm que ser unidas por uma instrução SELECT. Este campo
é obrigatório.
Exemplo:
SELECT o.order_key, customer_name, customer_email, p.part_key, color, quantity,
price, tax, ship_id, date, mode from order_tab o, part_tab p,
table (select substr(char(timestamp(generate_unique())),16)
as ship_id, date, mode, part_key from ship_tab) s
WHERE o.order_key = 1 and
p.price > 20000 and
p.order_key = o.order_key and
s.part_key = p.part_key
ORDER BY order_key, part_key, ship_id
A instrução SQL usa as seguintes diretrizes:
- Colunas são especificadas em ordem descendente, pela hierarquia
da estrutura do documento XML.
- As colunas para uma entidade são agrupadas, e cada grupo possui uma
coluna para a ID de objeto.
- A coluna de ID de objeto é a primeira coluna em cada grupo.
- Para tabelas que não usam uma coluna condicional de chave individual, use a função
incorporada do DB2 generate_unique para gerar a coluna.
- As colunas de ID de objeto são então listadas em ordem descendente
nas instruções ORDER BY. As colunas em ORDER BY não devem ser qualificadas
por qualquer esquema e nome de tabela e não devem relacionar os nomes de
coluna na cláusula SELECT.
- Testar SQL
- Testa a validade da instrução SQL. Se a instrução for válida,
amostras de resultados serão mostradas no campo Amostras de resultados. Se não
for, uma mensagem de erro pedirá que a instrução seja corrigida e que
o processo seja repetido.
- Resultados de amostra
- Mostra os resultados obtidos quando a instrução SQL
é testada e sua validade é comprovada. Este campo é somente para
leitura.
- Voltar
- Vai para a etapa anterior: Selecionar validação.
- Próximo
- Vá para a próxima etapa: Mapa do SQL.
- Encerrar
- Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui
o processo e retorna para a Barra de Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Mapa DAD
- Selecione um nó do mapa DAD exibido para
que a partir dele seja feito o mapeamento. Podem ser mapeados os
elementos e atributos do documento XML para nós de elemento e de
atributo que correspondam a dados do DB2. Os nós fornecem o caminho
entre os dados do XML e os dados do DB2. Selecione um nó para ativar Novo
Elemento. Selecionar um nó provoca o aparecimento dos campos pertinentes
na caixa de grupo Detalhes.
- Tipo do nó
- Selecione um tipo de nó na lista de tipos válidos neste ponto
do mapa. Dependendo do tipo de nó selecionado, são exibidos diferentes
campos na caixa de grupo Detalhes. Este campo
é obrigatório.
- Elemento
- Representa um elemento XML definido no DTD associado ao documento XML
e usado para associar o elemento XML a uma coluna em uma tabela DB2.
Um nó de elemento pode ter nós de atributo, nós de elementos filhos
ou nós de texto. Um nó de nível inferior possui um nó de texto e um
nome de coluna associados a ele na exibição de árvore.
- Atributo
- Representa um atributo XML definido no DTD associado ao documento XML
e usado para associar o atributo do XML a uma coluna em uma tabela DB2.
Um nó de atributo pode ter um nó de texto e um nome de coluna
associados a ele na exibição de árvore.
- Texto
- Especifica o conteúdo de texto do nó de elemento. Um nó de
texto possui um nome de coluna associado a ele na exibição de árvore.
- Nome do nó
- Digite o nome do nó. Este campo
é obrigatório.
Exemplo:
Order
- Coluna
- Se tiver selecionado Atributo, Elemento, ou
Texto como o tipo de nó, selecione um nome de coluna. Este campo
é obrigatório.
Se você especificar Coluna como o tipo
de nó, você pode selecionar somente uma coluna que já exista no seu
banco de dados DB2.
Exemplo:
Customer_Name
- Incluir
- Inclui o devido rótulo no elemento vazio que
estiver sendo incluído na estrutura de árvore.
- Alterar
- Faz as alterações no nó em destaque. Pode-se selecionar o
mesmo nó novamente ou outro nó e fazer outras modificações.
- Remover
- Remove o elemento ou atributo em destaque.
- Novo Elemento
- Cria um novo nó limpando os campos na caixa de grupo Detalhes,
anexa um elemento vazio abaixo do que está destacado na estrutura em formato de árvore,
e destaca o novo elemento vazio.
- Voltar
- Vai para a etapa anterior: Especifique a instrução SQL.
- Próximo
- Vai para próxima etapa: Salvar um DAD.
- Encerrar
- Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui
o processo e retorna para a Barra de Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Mapa DAD
- Selecione um nó do mapa DAD exibido para
que a partir dele seja feito o mapeamento. Os elementos e atributos no
documento XML são mapeados em nós de elemento e de atributo correspondentes
a dados DB2. Os nós fornecem o caminho
entre os dados do XML e os dados do DB2. Eles indicam quais tabelas e quais
colunas possuem os dados e sob que condições é possível obter os dados. Selecione
um nó para ativar Novo Elemento. Selecionar um nó provoca o aparecimento
dos campos pertinentes na caixa de grupo Detalhes.
- Tipo do nó
- Selecione um tipo de nó na lista de tipos válidos neste ponto
do mapa. Dependendo do tipo de nó selecionado, são exibidos diferentes campos
na caixa de grupo Detalhes. Os campos podem ser para
Elemento, Atributo, Texto, Tabela,
Coluna ou Condição, dependendo do que foi selecionado
no mapa DAD. Este campo
é obrigatório.
- Elemento
- Representa um elemento XML definido no DTD associado ao documento XML
e usado para associar o elemento XML a uma coluna em uma tabela DB2.
Um nó de elemento pode possuir nós de atributo, nós de elemento filhos,
nós de texto, nós de tabela ou nós de condição. Um elemento raiz possui
nós de tabela para especificar todas as tabelas usadas para gerar documentos
XML e um nó de condição usado para conectar as tabelas. Este campo
é obrigatório.
Exemplo:
nome do nó_elemento="Order"
- Atributo
- Representa um nó de atributo XML definido no DTD associado ao documento XML
e usado para associar o atributo XML a uma coluna em uma tabela DB2. Um nó de atributo
pode possuir um nó de texto e possui um nome de coluna associado a ele no mapa DAD. Dados
estão localizados no nó de atributo e no nó de texto de cada elemento. Este campo
é obrigatório.
Exemplo:
nome do nó_atributo="key"
|
- |Tabela
- |Representa a tabela associada ao conteúdo do nó de texto
|ou do nó de atributo. Especifica o nome de uma tabela DB2 na qual o conteúdo
|do nó de texto ou do nó de atributo será armazenado ou a partir da qual será
|recuperado. Exemplo:
|nome do nó_tabela=order_tab
|
- |Coluna
- |Representa a coluna que contém o conteúdo do nó de texto ou do
|nó de atributo. Especifica o nome de uma coluna da tabela DB2 na qual
|o conteúdo do nó de texto ou do nó de atributo será armazenado ou
|da qual será recuperado. Exemplo:
|nome da coluna="order_key"
- Nome do nó
- Digite o nome de um elemento ou atributo. Este campo
é obrigatório.
Exemplo:
nome do nó_elemento="Price"
- Texto
- Indica o conteúdo de texto de um elemento e os dados de coluna
em uma tabela relacional para os nós de elemento do nível inferior. Contém um elemento
de tabela, um elemento de coluna e, para o nó raiz, um elemento de condição.
- Nome da tabela
- O nome da tabela que contém a coluna. Exemplo:
nome da tabela="order_tab"
nome da tabela="part_tab"
Nome da tabela="ship_tab"
- Chave da tabela
- A chave primária para uma tabela, constituída de uma coluna individual
ou de múltiplas colunas (chave composta). A chave é usada para ligar tabelas em uma
coleção. Exemplo de chave composta:
nome de tabela="part_tab" chave="part_key, price"
- Coluna
- Nome da coluna que contém os dados para o texto do elemento e na qual o
elemento e o atributo são mapeados. Exemplo:
nome de coluna="order_key" tipo="integer"
- Condição
- Em elementos raiz, indica o modo de unir tabelas de coleção XML.
Em elementos de nível inferior, indica os critérios para selecionar dados XML
com valores "=", "<", ">" ou "LIKE". Exemplo de condição para o elemento raiz:
order_tab.order_key = part_tab.order_key AND
part_tabe.part_key = ship_tab.part._key
Exemplo de critérios para selecionar dados XML:
preço > 2500.00
- Incluir
- Inclui o rótulo apropriado no elemento vazio que estiver
sendo incluído na estrutura de árvore.
- Alterar
- Efetua alterações no nó destacado. Pode-se selecionar o
mesmo nó novamente ou outro nó e fazer outras modificações.
- Remover
- Remove o elemento em destaque.
- Novo Elemento
- Cria um novo nó limpando os campos na caixa de grupo Detalhes,
anexa um elemento vazio abaixo do que está destacado na estrutura em formato de árvore
e destaca o novo elemento vazio.
- Voltar
- Vai para a etapa anterior: Especifique o texto.
- Próximo
- Vai para a próxima janela: Salvar um DAD.
- Encerrar
- Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui
o processo e retorna para a Barra de Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Nome do arquivo
- Digite o nome do arquivo para o DAD modificado ou novo que deseja salvar
ou clique em ... para abrir a janela do navegador de arquivo local e selecionar
a localização onde o DAD deve ser salvo. Este campo
é obrigatório.
- Voltar
- Vai para a etapa anterior.
- Encerrar
- Salva o arquivo DAD e retorna para a Barra de Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
Quando um DAD para uma coluna XML é criada, especifica-se o tipo de
dados do documento XML e definem-se tabelas laterais, usadas para
fazer indexação.
- |Clique em Editar DAD na Barra de Lançamento para editar ou criar um
|arquivo DAD XML. O assistente Trabalhar com arquivos DAD é aberto e exibe a
|janela Especifique um DAD.
- Escolha se deseja editar um arquivo DAD que já existe ou criar
um arquivo DAD novo.
- Para editar um DAD existente:
- Clique em ... para navegar num arquivo DAD que já existe
na lista ou digite o nome do arquivo DAD no campo Nome do
arquivo.
- Veja se o assistente reconhece o arquivo DAD especificado.
- Se reconhecer, a opção Próximo estará selecionável e no
campo Tipo aparecerá Coluna XML.
- Se o assistente não reconhecer o arquivo DAD especificado, a
opção Próximo não estará selecionável. Digite novamente o nome do
arquivo DAD no campo Nome do arquivo ou clique em ... para
navegar novamente até um arquivo DAD existente. Continue até Próximo estar selecionável.
- Clique em Próximo.
- Para criar um novo DAD:
- Deixe o campo Nome do arquivo em branco.
- A partir da lista Tipo, clique na Coluna XML.
- Clique em Próximo.
- Escolha na janela Selecionar Validação se quer validar seus
documentos XML com um DTD.
- Clique em Próximo.
- Escolha se deseja incluir uma tabela lateral nova, editar uma
que já exista ou excluir uma tabela lateral existente da janela
Tabelas laterais.
- Para incluir uma tabela lateral ou uma coluna de tabela lateral nova:
Para incluir uma tabela lateral nova, definem-se as colunas da
tabela.
Execute os passos abaixo para cada coluna da tabela lateral.
- Complete os campos da caixa Detalhes da janela Tabelas
laterais.
- Nome da tabela: Digite o nome da tabela que contém a
coluna.
- Nome da coluna: Digite o nome da coluna.
- Tipo: Selecione o tipo de coluna a partir da lista.
- Comprimento (apenas tipo VARCHAR): Digite o número
máximo de caracteres VARCHAR.
- Caminho: Digite a localização do elemento ou
atributo.
- Ocorrência múltipla: Selecione na lista Não ou
Sim.
Indica se o elemento ou atributo pode ser usado mais de uma vez
num documento. Importante Se for especificada uma ocorrência
múltipla para uma coluna, só é possível especificar uma coluna na
tabela lateral que contém a coluna.
- Clique em Incluir para incluir uma coluna.
- Continue incluindo, editando ou removendo colunas da tabela
lateral ou clique em Próximo.
- Para editar uma coluna de tabela lateral que já existe:
Pode-se atualizar uma tabela lateral alterando as definições das
colunas existentes.
- Clique na tabela lateral e no nome da coluna a ser editada.
- Edite os campos da caixa Detalhes.
- Clique em Alterar para salvar alterações.
- Continue incluindo, editando ou removendo colunas da tabela
lateral, ou então clique em Próximo.
- Para remover uma coluna de tabela lateral existente:
- Clique na tabela lateral e na coluna a ser removida.
- Clique em Remover.
- Continue a incluir, editar ou remover colunas de tabela lateral, ou clique em
Próximo.
- Para remover uma tabela lateral que já existe:
Exclua cada coluna na tabela lateral para remover a tabela.
- Clique em cada coluna da tabela lateral correspondente para a tabela que
deve ser removida.
- Clique em Remover.
- Continue incluindo, editando ou removendo colunas da tabela
lateral, ou então clique em Próximo.
- Digite um nome de arquivo de saída para o arquivo DAD
modificado no campo Nome do arquivo da janela Especificar um
DAD.
- Clique em Finalizar para salvar o arquivo DAD e retornar
para a Barra de Lançamento.
Quando se cria o DAD da coleção XML, mapeia-se o documento para a
origem de dados do DB2, usando para isso uma destas técnicas:
- Clique em |Editar DAD na Barra de Lançamento. A janela Especificar um
DAD é exibida.
- Escolha se deseja editar um arquivo DAD que já existe ou criar
um arquivo DAD novo.
Para criar um novo arquivo DAD:
- Deixe o campo Nome do arquivo em branco.
- Na lista Tipo, selecione Mapeamento SQL de
coleção XML.
- Clique em Próximo para abrir a janela Selecionar
Validação.
Para editar um arquivo DAD existente:
- Digite o nome do arquivo DAD dentro do campo Nome do arquivo ou clique em
... para navegar para um arquivo DAD existente.
- Veja se o assistente reconhece o arquivo DAD especificado.
- Se reconhecer, a opção Próximo estará selecionável e o
mapeamento SQL de coleção XML será exibido no campo Tipo.
- Se o assistente não reconhecer o arquivo DAD especificado, a
opção Próximo não estará selecionável. Digite novamente o nome do arquivo DAD ou clique em
... para navegar novamente para um arquivo DAD que já exista. Repita os passos até que Próximo fique selecionável.
- Clique em Próximo para abrir a janela Selecionar
Validação.
- Na janela Selecionar Validação, escolha se quer validar seus
documentos XML com um DTD.
- Clique em Próximo para abrir a janela Especificar
Texto.
- Digite o prólogo no campo Prólogo, para
especificar o prólogo do documento XML a ser composto.
<?xml version="1.0"?>
Quando se edita um DAD que já existe, o prólogo é automaticamente
exibido no campo Prólogo.
- Digite o tipo de documento XML no campo Tipodoc da
janela Especificar Texto, apontando para o DTD relativo ao documento
XML. Exemplo:
|<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
Quando se edita um DAD que já existe, o tipo do documento aparece
automaticamente no campo Tipodoc.
- Clique em Próximo para abrir a janela Especificar Instrução SQL.
- Digite uma instrução SQL SELECT válida no campo
Instrução SQL.
Se estiver editando um DAD existente, a instrução SQL
será exibida automaticamente no campo Instrução SQL.
- Clique em Testar SQL para testar a validade da
instrução SQL.
- Se sua instrução SQL for válida, os resultados de amostra serão
exibidos no campo Resultados de amostra.
- Se não for, será dada uma mensagem de erro no campo
Resultados de amostra. A mensagem de erro ensina a
corrigir a instrução SQL SELECT e a tentar de novo.
- |Clique em Próximo para abrir a janela Mapear SQL.
- Selecione um nó de elemento ou atributo a partir do qual o mapeamento será feito,
clicando nele no campo a esquerda da janela |Mapear SQL.
Mapeie os elementos e atributos do documento XML para os nós de
elemento e atributo que correspondem a dados do DB2. Esses nós
fornecem o caminho entre os dados do XML e os dados do DB2.
- Digite o nome de um arquivo de saída para o arquivo DAD modificado no campo Nome
do arquivo da janela Especificar um DAD.
- Clique em Finalizar para retornar até a Barra de Lançamento.
- Clique em |Editar DAD na Barra de Lançamento. A janela Especificar
um DAD é exibida.
- Escolha se deseja editar um arquivo DAD que já existe ou criar
um DAD novo.
Para editar um DAD existente:
- Digite o nome do arquivo DAD dentro do campo Nome do
arquivo ou clique em ... para navegar até um DAD
existente.
- Veja se o assistente reconhece o arquivo DAD especificado.
- Se reconhecer, a opção Próximo estará selecionável e será
exibido no campo Tipo o mapeamento RDB_node de coleção XML.
- Se o assistente não reconhecer o arquivo DAD especificado, a
opção Próximo não estará selecionável. Digite novamente o nome do arquivo DAD no campo Nome
do arquivo ou clique em ... para navegar novamente para um
arquivo DAD que já exista. Continue executando os passos até Próximo estar selecionável.
- Clique em Próximo para abrir a janela Selecionar
Validação.
Para criar um novo DAD:
- Deixe o campo Nome do arquivo em branco.
- Selecione Mapeamento do nó RDB da coleção XML na lista
Tipo.
- Clique em Próximo para abrir a janela Selecionar
Validação.
- Na janela Selecionar Validação, escolha se quer validar seus
documentos XML com um DTD.
- Clique em Próximo para abrir a janela Especificar
Texto.
- Digite o nome do prólogo no campo Prólogo da janela
Especificar Texto.
<?xml versão="1.0"?>
Quando se edita um DAD que já existe, o prólogo é automaticamente
exibido no campo Prólogo.
- Digite o tipo de documento XML no campo Tipodoc. Exemplo:
|<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
Quando se edita um DAD que já existe, o tipo do documento aparece
automaticamente no campo Tipodoc.
- |Clique em Próximo para abrir a janela Mapear nós RDB.
- Selecione um nó de elemento ou atributo a partir do qual o mapeamento será feito, clicando
nele no campo a esquerda da janela |Mapear nós RDB.
Mapeie os elementos e atributos do documento XML para os nós de
elemento e atributo que correspondem a dados do DB2. Esses nós
fornecem o caminho entre os dados do XML e os dados do DB2.
- Para incluir o nó raiz:
- Selecione o ícone Raiz.
- Clique em Novo Elemento para definir um novo nó.
- Na caixa Detalhes, especifique o Tipo de nó como
Elemento.
- Digite o nome do nó raiz no campo Nome do nó.
- Clique em Incluir para criar o novo nó.
Foi criado o nó ou elemento raiz, que é o pai de
todos os outros nós de elemento e atributo do mapa. O nó raiz possui
elementos da tabela filho e uma condição de união.
Inclua nós de tabela para cada tabela que seja parte da coleção.
- Destaque o nome do nó raiz e selecione Novo Elemento.
- Na caixa Detalhes, especifique o Tipo de nó como
Tabela.
- Selecione o nome da tabela a partir de Nome da tabela. A tabela precisa existir.
- Clique em Incluir para incluir o nó de tabela.
- Repita estas etapas para cada tabela.
Inclua uma condição de união para os nós de tabela.
- Destaque o nome do nó raiz e selecione Novo Elemento.
- Na caixa Detalhes, especifique o Tipo de nó como
Condição.
- No campo Condição, digite a condição de união usando a
seguinte sintaxe:
table_name.table_column = table_name.table_column AND
table_name.table_column = table_name.table_column ...
Inclua tantas condições, unidas por AND, quantas forem necessárias
para criar a condição de união.
- Clique em Incluir para incluir a condição.
Podem ser
incluídos agora os elementos e atributos filhos desse nó.
- Para incluir um elemento filho ou um nó de atributo:
- Clique num nó pai no campo da esquerda e inclua um elemento ou
atributo filho.
- Clique em Novo Elemento.
Se não foi selecionado o nó pai, a opção Novo Elemento não
estará selecionável.
- Selecione um tipo de nó a partir da lista Tipo de nó
na caixa Detalhes.
A lista Tipo do nó exibe apenas os tipos de nó válidos
naquele ponto do mapa, que são Elemento ou Atributo.
- Digite o nome do elemento ou atributo no campo Nome do nó.
- Se for especificado como Tipo do nó,
Atributo, ou como elemento de nível inferior, Elemento,
selecione uma coluna no campo Coluna na caixa Detalhes.
Restrição: Não podem ser criadas novas colunas com o
assistente de administração. Se você especificar Coluna como o tipo
de nó, você pode selecionar somente uma coluna que já exista no seu
banco de dados DB2.
- Clique em Incluir para incluir o novo nó.
Para modificar um nó mais tarde, clique sobre ele no campo da
esquerda e faça as modificações necessárias na caixa Detalhes.
Clique em Alterar para atualizar o elemento.
Também é possível incluir elementos ou atributos filho no nó;
para isso basta colocá-lo em destaque e repetir o processo de
inclusão.
- Para mapear o conteúdo de um nó de elemento ou de atributo
em uma tabela relacional:
- Especifique um nó de texto.
- Clique no nó pai.
- Clique em Novo Elemento.
- No campo Tipo de nó, selecione Texto.
- Selecione Incluir para incluir o nó.
- Inclua um nó de tabela.
- Selecione o nó de texto que acabou de ser criado e clique em Novo
Elemento.
- No campo Tipo de nó, selecione Tabela e especifique
um nome de tabela para o elemento.
- Clique em Incluir para incluir o nó.
- Inclua um nó de coluna.
- Selecione o nó de texto novamente e clique em Novo Elemento.
- No campo Tipo de nó, selecione Coluna e especifique
um nome de coluna para o elemento.
- Clique em Incluir para incluir o nó.
Restrição: Não podem ser criadas novas colunas com o
assistente de administração. Se você especificar Coluna como o tipo
de nó, você pode selecionar somente uma coluna que já exista no seu
banco de dados DB2.
- Inclua opcionalmente uma condição para a coluna.
- Selecione o nó de texto novamente e clique em Novo Elemento.
- No campo Tipo de nó, selecione Condição e a condição com a sintaxe:
operador LIKE|<|>|= valor
- Clique em Incluir para incluir o nó.
- Continue editando o mapa RDB_node ou clique em
Próximo para abrir a janela Especificar um DAD.
- Para remover um nó:
- Clique num nó do campo da esquerda.
- Clique em Remover.
- Continue editando o mapa RDB_node ou clique em
Próximo para abrir a janela Especificar um DAD.
- Digite em um nome de arquivo de saída para o DAD modificado
no campo Nome do arquivo da janela Especificar um DAD.
- Clique em Finalizar para remover o nó e retornar para a Barra
de Lançamento.
- Clique em |Editar DAD na Barra de Lançamento. A janela
Especificar um DAD é exibida.
- Escolha se deseja editar um arquivo DAD que já existe ou criar
um DAD novo.
Para editar um DAD existente:
- Digite o nome do arquivo DAD dentro do campo Nome do
arquivo ou clique em ... para navegar até um DAD
existente.
- Veja se o assistente reconhece o arquivo DAD especificado.
- Se reconhecer, a opção Próximo estará selecionável e será
exibido no campo Tipo o mapeamento RDB_node de coleção XML.
- Se o assistente não reconhecer o arquivo DAD especificado, a
opção Próximo não estará selecionável. Digite novamente o nome do arquivo DAD no campo Nome
do arquivo ou clique em ... para navegar novamente para um
arquivo DAD que já exista. Continue executando os passos até Próximo estar selecionável.
- Clique em Próximo para abrir a janela Selecionar
Validação.
Para criar um novo DAD:
- Deixe o campo Nome do arquivo em branco.
- Selecione Mapeamento RDB_node de coleção XML na lista
Tipo.
- Clique em Próximo para abrir a janela Selecionar
Validação.
- Na janela Selecionar Validação, escolha se quer validar seus
documentos XML com um DTD.
- Clique em Próximo para abrir a janela Especificar
Texto.
- Ao decompor apenas um documento XML, ignore o campo
Prólogo. Ao usar o arquivo DAD tanto para composição quanto
decomposição, digite o nome do prólogo no campo Prólogo
da janela Especificar Texto. O prólogo não é necessário quando se
decompõem documentos XML em dados do DB2.
<?xml versão="1.0"?>
Quando se edita um DAD que já existe, o prólogo é automaticamente
exibido no campo Prólogo.
- Ao decompor apenas um documento XML, ignore o campo
Tipodoc. Se estiver usando o arquivo DAD tanto para composição
quanto para decomposição, digite o tipo do documento XML no campo
Tipodoc
Quando se edita um DAD que já existe, o tipo do documento aparece
automaticamente no campo Tipodoc.
Exemplo:
|<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
- Clique em Próximo para abrir a janela Mapeamento RDB.
- Selecione um nó de elemento ou de atributo a partir do qual o
mapeamento será feito, clicando sobre ele no campo à
esquerda da janela Mapeamento RDB.
Mapeie os elementos e atributos do documento XML para os nós de
elemento e de atributo que correspondem a dados do DB2. Esses nós
fornecem o caminho entre os dados do XML e os dados do DB2.
- Para incluir o nó raiz:
- Selecione o ícone Raiz.
- Clique em Novo Elemento para definir um novo nó.
- Na caixa Detalhes, especifique o Tipo de nó como
Elemento.
- Digite o nome do nó raiz no campo Nome do nó.
- Clique em Incluir para criar o novo nó.
Foi criado o nó ou elemento raiz, que é o pai de
todos os outros nós de elemento e atributo do mapa. O nó raiz possui
elementos de tabela filhos e uma condição de união.
Inclua nós de tabela para cada tabela que seja parte da coleção.
- Destaque o nome do nó raiz e selecione Novo Elemento.
- Na caixa Detalhes, especifique o Tipo de nó como
Tabela.
- Selecione o nome da tabela a partir de Nome da tabela. A tabela precisa existir.
- Especifique uma coluna-chave para a tabela no campo Chave de tabela.
- Clique em Incluir para incluir o nó de tabela.
- Repita estas etapas para cada tabela.
Inclua uma condição de união para os nós de tabela.
- Destaque o nome do nó raiz e selecione Novo Elemento.
- Na caixa Detalhes, especifique o Tipo de nó como
Condição.
- No campo Condição, digite a condição de união usando a seguinte sintaxe:.
table_name.table_column = table_name.table_column AND
table_name.table_column = table_name.table_column ...
- Clique em Incluir para incluir a condição.
Podem ser
incluídos agora os elementos e atributos filhos desse nó.
- Para incluir um elemento filho ou um nó de atributo:
- Clique num nó pai no campo da esquerda e inclua um elemento ou
atributo filho.
Se não foi selecionado o nó pai, a opção Novo não
estará selecionável.
- Clique em Novo Elemento.
- Selecione um tipo de nó a partir da lista Tipo de nó
na caixa Detalhes.
A lista Tipo do nó exibe apenas os tipos de nó válidos
naquele ponto do mapa, que são Elemento ou Atributo.
- Clique em Incluir para incluir o novo nó.
É possível modificar posteriormente um nó ao clicar nele no campo à
esquerda e efetuar as modificações necessárias na caixa Detalhes. Clique em
Alterar para atualizar o elemento.
- Para mapear o conteúdo de um nó de elemento ou de atributo em uma
tabela relacional:
- Especifique um nó de texto.
- Clique no nó pai.
- Clique em Novo Elemento.
- No campo Tipo de nó, selecione Texto.
- Selecione Incluir para incluir o nó.
- Inclua um nó de tabela.
- Selecione o nó de texto que acabou de ser criado e clique em Novo
Elemento.
- No campo Tipo de nó, selecione Tabela e especifique
um nome de tabela para o elemento.
- Clique em Incluir para incluir o nó.
- Inclua um nó de coluna.
- Selecione o nó de texto novamente e clique em Novo Elemento.
- No campo Tipo de nó, selecione Coluna e especifique
um nome de coluna para o elemento.
- Especifique um dos tipos de dados base para a coluna no campo Tipo, para
especificar qual tipo de coluna deve ser usado para armazenar os dados não marcados.
- Clique em Incluir para incluir o nó.
Restrição: Não podem ser criadas novas colunas com o
assistente de administração. Se você especificar Coluna como o tipo
de nó, você pode selecionar somente uma coluna que já exista no seu
banco de dados DB2.
- Inclua opcionalmente uma condição para a coluna.
- Selecione o nó de texto novamente e clique em Novo Elemento.
- No campo Tipo de nó, selecione Condição e a condição
com a sintaxe:
operador LIKE|<|>|= valor
- Clique em Incluir para incluir o nó.
- Continue editando o mapa RDB_node ou clique em
Próximo para abrir a janela Especificar um DAD.
- Para remover um nó:
- Clique num nó do campo da esquerda.
- Clique em Remover.
- Continue editando o mapa RDB_node ou clique em
Próximo para abrir a janela Especificar um DAD.
- Digite em um nome de arquivo de saída para o DAD modificado
no campo Nome do arquivo da janela Especificar um DAD.
- Clique em Finalizar para remover o nó e retornar para a Barra
de Lançamento.
Com este assistente é possível incluir, habilitar ou desabilitar
colunas XML do XML Extender.
- Incluir uma Coluna XML
- Selecione para abrir a janela Incluir uma coluna XML para
incluir uma coluna numa tabela. Esta coluna conterá um documento XML intacto. Essa
opção estará disponível somente se o banco de dados estiver habilitado.
- |Ativar uma coluna XML
- Selecione para abrir a |janela Ativar uma coluna XML para se conectar em um
banco de dados e ativar uma coluna XML para que esta possa conter UDTs do XML Extender. Esta opção estará disponível somente
se o banco de dados for habilitado e as colunas estiverem criadas para
documentos XML.
- |Desativar uma coluna XML
- Selecione para abrir a |janela Desativar coluna XML para desativar uma coluna existente. Se o banco de dados não estiver
habilitado ou uma coluna XML habilitada não existir, esta opção não estará
disponível. Uma coluna desabilitada não pode mais conter documentos
XML. É preciso desabilitar a coluna XML antes de eliminar uma tabela
XML. Se uma tabela for eliminada e sua coluna XML não for desabilitada,
o XML Extender conservará as tabelas laterais criadas e a entrada da
coluna XML na tabela de utilização XML.
- Próximo
- Abra a janela selecionada para incluir, habilitar ou desabilitar
uma coluna XML.
- Encerrar
- Disponível quando você acaba de trabalhar com a coluna.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Nome da tabela
- Digite o nome da tabela ou selecione o nome a partir da lista de
tabelas disponíveis. A tabela deve ser definida para incluir uma coluna XML.
Exemplo:
SALES_DB
- Nome da coluna
- Digite o nome que você deseja usar para a coluna XML.
Exemplo:
ORDER
- |Tipo de dados
- Selecione o tipo de dados a partir da lista de tipos disponíveis, como XMLCLOB,
XMLVARCHAR ou XMLFILE. Exemplo:
XMLVARCHAR
- Voltar
- Abre na janela Selecionar uma tarefa usada para trabalhar com colunas XML.
- Encerrar
- Inclui a coluna XML e retorna para a Barra de Lançamento.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Nome da tabela
- Digite o nome da tabela que possui uma coluna XML ou selecione o nome a partir da
lista de nomes de tabelas disponíveis.
Exemplo
SALES_TAB
- Nome da coluna
- Digite o nome de uma coluna XML existente na tabela ou selecione o nome
a partir da lista de colunas disponíveis.
Exemplo:
ORDER
- Nome do arquivo DAD
- Digite a localização do arquivo DAD que mapeia o documento XML para a coluna XML
e para as tabelas laterais ou clique em ... para procurar um arquivo DAD existente. Exemplo:
c:\dxx\samples\dad\getstart.dad
- Table space
- Opcional: Digite o nome de um tablespace criado anteriormente para tabelas laterais
associadas à coluna XML. Se o table space não estiver especificado,
um table space padrão será utilizado.
- View padrão
- Opcional: Digite o nome de uma view padrão que une a tabela XML e todas as tabelas
laterais relacionadas.
- |ID da raiz
- Recomendado, mas opcional: digite o nome de coluna da chave primária na
tabela para associar todas as tabelas laterais com a tabela da aplicação.
Se não for especificado uma ID DA RAIZ, o XML Extender inclui uma coluna DXXROOT_ID na
tabela e gera um identificador.
- Voltar
- Abre na janela Selecionar uma tarefa usada para trabalhar com colunas XML.
- Encerrar
- Ativa a coluna XML e retorna para a Barra de Lançamento. Para habilitar
a coluna, o XML Extender determina se a tabela XML tem chave
primária, cria tabelas laterais que são especificadas no arquivo DAD
e cria uma view padrão para a tabela XML e para as tabelas
laterais.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento
- Nome da tabela
- Digite o nome da tabela que contém a coluna XML ou selecione o nome a partir
da lista de tabelas disponíveis.
- Nome da coluna
- Digite o nome de uma coluna existente na tabela ou selecione o nome a partir
da lista de nomes da coluna.
- Voltar
- Abre na janela Selecionar uma tarefa usada para trabalhar com colunas XML.
- Encerrar
- Desativa a coluna XML e retorna para a Barra de Lançamento. Uma coluna desativada
não pode mais conter documentos XML.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Clique em Trabalhar com colunas XML na Barra de
Lançamento. A janela Selecionar uma tarefa é aberta.
- Clique em Incluir uma Coluna XML. A janela Incluir uma coluna
XML é aberta.
- Selecione o nome da tabela a partir da lista Nome da
tabela ou digite o nome da tabela a ser alterada.
- Digite o nome da coluna para ser incluído a tabela no campo Nome
da coluna.
- Selecione o UDT para a coluna a partir da lista |Tipo de dados.
- Clique em Encerrar para incluir a coluna do tipo XML.
- Clique em Trabalhar com colunas XML na Barra de
Lançamento para exibir as tarefas relacionadas a coluna do XML
Extender. Abre-se a janela Selecionar Tarefa.
- Clique em |Ativar uma Coluna XML e em seguida em Próximo para
ativar uma coluna de tabela existente no banco de dados.
- Selecione a tabela que contém a coluna XML a partir do campo Nome
da tabela.
- Selecione a coluna que está sendo habilitada no campo
Nome da coluna. A coluna deve existir e ser do tipo XML.
- Digite o caminho do DAD e o nome do arquivo dentro do campo
Nome do arquivo DAD ou clique em ... para navegar até
um arquivo DAD existente.
- Opcionalmente, digite o nome de um table space existente no campo Table
space.
O tablespace contém tabelas laterais criadas pelo XML Extender.
Quando se especifica um tablespace, as tabelas laterais são criadas
nele. Quando não se especifica tablespace, as tabelas laterais são
criadas no tablespace padrão.
- Opcionalmente, digite o nome da view padrão no campo
View padrão.
Quando especificada, a view padrão é automaticamente criada no
momento em que a coluna é habilitada e une a tabela XML e todas as
tabelas laterais relacionadas a ela.
- Opcionalmente, digite o nome da coluna da chave primária na
tabela de aplicação no campo ID da Raiz. Isto é necessário.
O XML Extender usa o valor da ID raiz como identificador único
para associar todas as tabelas laterais com a tabela da aplicação. Quando
ela não é especificada, o XML Extender inclui uma coluna DXXROOT_ID
na tabela da aplicação e gera um identificador.
- Clique em Finalizar para ativar a coluna XML, criar as
tabelas laterais e retornar para a Barra de Lançamento.
- Se a habilitação da coluna ocorrer sem problemas, será dada a
mensagem Coluna habilitada com sucesso.
- Se ocorrerem problemas na habilitação, será apresentada uma
caixa de erro. Corrija os valores nos campos de entrada até que a coluna
seja ativada com sucesso.
- Clique em Trabalhando com colunas XML na Barra de
Lançamento para exibir as tarefas relacionadas a coluna do XML
Extender. Abre-se a janela Selecionar Tarefa.
- Clique em |Desativar uma Coluna XML e em seguida em Próximo na janela Selecione
uma Tarefa para desativar uma coluna de tabela existente no banco de dados.
- Selecione a tabela que contém a coluna XML a partir do campo Nome
da tabela.
- Selecione no campo Nome da coluna a coluna que
está sendo desabilitada.
- Clique em Finalizar.
- Se a desabilitação da coluna ocorrer sem problemas, será dada a
mensagem Coluna desabilitada com sucesso.
- Se ocorrerem problemas na desabilitação, será apresentada uma
caixa de erro. Corrija os valores nos campos de entrada até que a coluna
seja desativada com sucesso.
Com este assistente, é possível habilitar ou desabilitar coleções XML.
- Habilitar uma Coleção XML
- Selecione para abrir a janela Habilitar uma coleção XML. Habilitar uma coleção XML faz com que o arquivo DAD seja analisado para
identificar as tabelas e colunas relacionadas a documentos
XML e faz com que sejam registradas informações de controle. Esta
opção só fica disponível se o banco de dados estiver habilitado e
existir um arquivo DAD.
- Desabilitar uma Coleção XML
- Selecione para abrir a janela Desabilitar uma coleção ou para
remover marcadores que identificam tabelas e colunas como parte de
uma coleção XML. Se a coleção não estiver habilitada, esta opção não
estará disponível.
- Próximo
- Abre a janela selecionada para habilitar ou desabilitar uma
coleção XML.
- Encerrar
- Disponível quando você acaba de trabalhar com a coleção.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Nome da coleção
- Digite o nome da coleção XML que você deseja habilitar.
- Nome do arquivo DAD
- Digite o nome do arquivo DAD que mapeia a estrutura do documento XML nas tabelas
DB2 a partir das quais um documento foi composto ou decomposto ou clique em
... para procurar um arquivo DAD existente.
- ...
- Abra uma janela Procurar para selecionar um nome de arquivo DAD existente.
- Table space
- Digite o nome de um tablespace criado antes se ele existir.
Ele conterá as novas tabelas do DB2 geradas para composição ou
decomposição.
- Voltar
- Abre a janela Selecionar uma tarefa usada para trabalhar
com coleções XML.
- Encerrar
- Ativa a coleção XML e retorna para a Barra de Lançamento. Para
habilitar a coleção, o XML Extender usou o arquivo DAD para identificar
as tabelas e colunas dos documentos XML, registrando informações de
controle na tabela XML_USAGE.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Nome da coleção
- Selecione o nome da coleção XML que você deseja desabilitar a partir da
lista de coleções.
- Voltar
- Abre a janela Selecionar uma tarefa usada para trabalhar
com coleções XML.
- Encerrar
- Desativa a coleção XML e retorna para a Barra de Lançamento. Para
desabilitar uma coleção, o XML Extender remove marcadores que
identificam tabelas e colunas como parte de uma coleção XML.
- Cancelar
- Cancela o assistente e retorna para a Barra de Lançamento.
- Clique em Trabalhar com Coleções XML na Barra de
Lançamento. A janela Selecionar uma Tarefa é exibida.
- Clique em |Ativar uma Coleção XML e em seguida em Próximo. A janela Habilitar uma Coleção
é exibida.
- Selecione o nome da coleção que você deseja habilitar no campo
Nome da coleção a partir da lista.
- Digite o nome do arquivo DAD dentro do campo Nome do arquivo DAD ou clique em
... para navegar para um arquivo DAD existente.
- Opcionalmente, digite no campo Tablespace o nome de
um tablespace criado antes.
Ele conterá as novas tabelas do DB2 geradas para decomposição.
- Clique em Finalizar para ativar a coleção e retornar
para a Barra de Lançamento.
- Se a habilitação da coleção ocorrer sem problemas, será dada a
mensagem Coleção habilitada com sucesso.
- Se ocorrerem problemas na habilitação, será apresentada uma
caixa de erro. Corrija os valores nos campos de entrada até que a coleção
seja ativada com sucesso.
- Clique em Trabalhar com Coleções XML na Barra de
Lançamento para exibir as tarefas relacionadas a coleção do XML
Extender. A janela Selecionar uma Tarefa é exibida.
- Clique em Desativar uma Coleção XML e em seguida em Próximo para
desativar uma coleção XML. A janela Desabilitar uma Coleção é
exibida.
- Digite o nome da coleção que você deseja desabilitar no campo Nome da
coleção.
- Clique em Finalizar para desativar a coleção e retornar
para a Barra de Lançamento.
- Se a desabilitação da coleção ocorrer sem problemas, será dada a
mensagem Coleção desabilitada com sucesso.
- Se ocorrerem problemas na desabilitação, será apresentada uma
caixa de erro. Corrija os valores nos campos de entrada até que a coleção
seja desativada com sucesso.