ID do artigo: 189657 - �ltima revis�o: ter�a-feira, 13 de julho de 2004 - Revis�o: 1.4

Como usar o comando de forma ADO

Clique aqui para exibir o artigo traduzido e o artigo original em ingl�s, lado a lado.

Exibir Aviso de Isen��o de Tradu��o Autom�tica

Aviso de Isen��o de Responsabilidade sobre Conte�do do KB Aposentado

Exibir os produtos aos quais esse artigo se aplica.

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que est� a utilizar. Foi desactivado o conte�do do artigo, que pode n�o ser relevante para si.

Este artigo descreve a sintaxe de comando ADO SHAPE para produzir conjuntos de registros hier�rquicos e explica como atravessar conjuntos de registros hier�rquicos. C�digo de exemplo VBA tamb�m � fornecido.

Voltar para o in�cio

Mais Informa��es

Voc� pode usar conjuntos de registros hier�rquicos como uma alternativa para sintaxe JOIN e GROUP BY quando voc� precisa acessar dados de resumo e pai-filho.

Conjuntos de registros hier�rquicos s�o usados em v�rios produtos: Xbase produtos use o comando SET RELATION, o Access usa "Segmented tabelas virtuais" internamente para relat�rios com n�veis de agrupamento e assim por diante. Hierarquias lhe d�o a capacidade para criar um ou v�rios conjuntos de registros, definir agrupamentos e especificar c�lculos agregados sobre conjuntos de registros filho. Embora voc� poderia implementar funcionalidade similar atrav�s de c�digo, essa funcionalidade desloca grande parte do trabalho comuns do desenvolvedor para o sistema.

Conjuntos de registros hier�rquicos est�o dispon�veis atrav�s o provedor MSDataShape, que � implementado pelo mecanismo de cursor do cliente.

Conjuntos de registros hier�rquicos diferem instru��es SQL JOIN e GROUP BY que com um JOIN , os campos da tabela pai e filho campos da tabela s�o representados no mesmo conjunto de registros. Com um conjunto de registros hier�rquico, o conjunto de registros cont�m apenas os campos da tabela pai. Al�m disso, o conjunto de registros cont�m um campo extra que representa os dados relacionados filho, que voc� pode atribuir a uma segunda vari�vel de conjunto de registros e percorrer.

Quando voc� estiver executando fun��es agregadas usando GROUP BY e operadores agregadas, somente os valores agregados aparecem no conjunto de registros. Com conjuntos de registros hier�rquicos, os valores agregados s�o representados no conjunto de registros pai e os registros de detalhes est�o no conjunto de registros filho.

Voc� pode criar tr�s tipos de formas, e cada tipo tem sua pr�pria pontos fortes e fracos. Voc� precisar� escolher o mecanismo que melhor atenda �s necessidades do seu aplicativo e do ambiente que � executar seu aplicativo em. Os tipos de SHAPE s�o da seguinte maneira:

Rela��o com
Par�metro com
Grupo com

As duas primeiras s�o semelhantes em que eles produzem uma hierarquia que caso contr�rio poderia ser representada por uma instru��o SQL JOIN . Diferem em que todos os registros pai e filho s�o lidos em um cache local antes de qualquer processamento continua na hierarquia da rela��o. Esse tipo de hierarquia tem uma alta sobrecarga inicial ao recuperar os registros, mas a sobrecarga � baixa ap�s a recupera��o inicial.

Inicialmente, hierarquias baseadas em par�metro somente ler os registros pai e buscar o filho registros sob demanda. Embora a sobrecarga inicial � reduzida, voc� deve emitir uma nova consulta filho para cada registro pai que � acessado e voc� deve manter a conex�o com a fonte de dados para, desde que o conjunto de registros seja aberto.

A hierarquia baseada em grupo � equivalente a produzir uma instru��o SQL agregada associada a um detalhe SQL instru��o ou executando fun��es agregadas em dados n�o-normalizados. Voc� n�o pode atualizar as colunas de resumo e as colunas calculadas porque pode ser derivados de mais de um registro. Como hierarquias baseadas em rela��o, todos os registros devem ser lidos antecipadamente.

Conjuntos de registros hier�rquicos s�o disponibilizados pela cl�usula SHAPE . Sintaxe simplificada � fornecido pela primeira vez, em seguida, exemplos com diagramas. Porque a sintaxe de forma pode obter bastante complexa, a gram�tica formal para a forma cl�usula � fornecida no final do artigo para permitir que voc� estender os exemplos. Voc� tamb�m pode usar o programa no final deste artigo para testar suas pr�prias instru��es de forma . Os exemplos a usam tabelas do banco de dados de exemplo Northwind.

Voltar para o in�cio

Sintaxe simplificada

   SHAPE {parent-statement}
   APPEND Aggregate
        | ({child-statement} [As Alias]
          RELATE parent-field TO child-field | parameter-marker
                 [, parent-field TO child-field | parameter-marker ...])
          [, Aggregate | ({child statement})...]

   SHAPE {non-normalized-statement} [AS Alias]
   COMPUTE Aggregate
         | Alias
         | ({child-statement} [As Alias] RELATE parent-field TO
                                        child-field | parameter-marker)
           [, Aggregate | Alias | ({child-statement}...)]
   [BY grouping-field [, grouping-field]]

   SHAPE {non-normalized-statement} [AS Alias]
   BY grouping-field [, grouping-field]

Voltar para o in�cio

OBSERVA��ES:

Se voc� selecionar campos id�ntico de diferentes tabelas, talvez seja necess�rio alias-los para garantir que o analisador de SHAPE funcione.
As fun��es de Forma APPEND da mesma forma para um OUTER JOIN em que de um registro pai � em retornado, mesmo n�o se existe nenhum registro filho para ele.
Agrega��es s� podem operar em campos os filhos imediatos do conjunto de registros. Para operar em campos de netos e assim por diante, voc� deve produzir agregados intermedi�rios. Consulte a hierarquia de grupo com Aggregate exemplo no final deste artigo para obter uma ilustra��o.
Se voc� usar uma fun��o agregada com a sintaxe de APPEND forma , o valor agregado ocupar� um campo acrescentado ao conjunto de resultados pai, que tamb�m cont�m os campos da instru��o pai. Por outro lado, a Forma COMPUTE e SHAPE BY crie um novo n�vel pai para os agregados e a n�o-normalizados-instru��o se torna o conjunto de registros filho.
O provedor SHAPE requer que voc� inclua alias para o n�o-normalizados-demonstrativo na cl�usula COMPUTE ao usar a Forma COMPUTE . Caso contr�rio, resulta em uma mensagem que n�o h� suporte para a funcionalidade, mesmo que ele n�o resulta em um erro de sintaxe.

Voltar para o in�cio

Exemplos

Hierarquia de rela��o simples:

   SHAPE  {select * from customers}
   APPEND ({select * from orders} AS rsOrders
           RELATE customerid TO customerid)

que produz:

   Customers.*
   rsOrders
        |
        +----Orders.*

em diagrama anterior, o conjunto de registros pai cont�m todos os campos da tabela Customers e um campo chamado rsOrders. rsOrders fornece uma refer�ncia ao conjunto de registros filho e cont�m todos os campos de pedidos tabela. Outros exemplos usam uma nota��o semelhante.

Hierarquia parametrizada:

   SHAPE  {select * from customers}
   APPEND ({select * from orders where customerid = ?} AS rsOrders
           RELATE customerid TO PARAMETER 0)

Isso resulta na mesma hierarquia como a hierarquia simples de rela��o.

Composto Relation hierarquia:

Este exemplo ilustra uma hierarquia de tr�s n�veis de clientes, pedidos e detalhes do pedido:

   SHAPE  {SELECT * from customers}
   APPEND ((SHAPE  {select * from orders}
            APPEND ({select * from [order details]} AS rsDetails
                   RELATE orderid TO orderid)) AS rsOrders
          RELATE customerid TO customerid)

que produz:

   Customers.*
   rsOrders
        |
        +----Orders.*
             rsDetails
                 |
                 +----[Order Details].*

Hierarquia de rela��o v�rios:

Este exemplo ilustra uma hierarquia envolvendo um conjunto de registros pai e dois conjuntos de registros filho, um dos quais � parametrizado:

   SHAPE  {SELECT * FROM customers}
   APPEND ({SELECT *
            FROM orders
            WHERE orderdate < #1/1/1998# AND customerid = ?}
            RELATE customerid TO PARAMETER 0) AS rsOldOrders,
          ({SELECT *
            FROM orders
            WHERE orderdate >= #1/1/1998#}
            RELATE customerid TO customerid) AS rsRecentOrders

que produz:

   Customers.*
   rsOldOrders
        |
        +----Orders.*
   rsRecentOrders
        |
        +----Orders.*

Hierarquia com agrega��o:

   SHAPE  (select * from orders}
   APPEND ({select od.orderid, od.UnitPrice * od.quantity as ExtendedPrice
            from [order details] As od}
          RELATE orderid TO orderid) As rsDetails,
          SUM(ExtendedPrice) AS OrderTotal

que produz:

   Orders.*
   rsDetails
       |
       +----orderid
            ExtendedPrice
   OrderTotal

Hierarquia de grupo:

   SHAPE  {select customers.customerid AS cust_id, orders.*
           from customers inner join orders
           on customers.customerid = orders.customerid} AS rsOrders
   COMPUTE rsOrders BY cust_id

que produz:

   rsOrders
       |
       +----cust_id
            Orders.*
   cust_id

Hierarquia de grupo com agrega��o:

Observa��o : A cl�usula interna SHAPE neste exemplo � id�ntica � instru��o usada na hierarquia com exemplo Aggregate.

   SHAPE
           (SHAPE   {select customers.*, orders.orderid, orders.orderdate
                     from customers inner join orders
                     on customers.customerid = orders.customerid}
            APPEND  ({select od.orderid,
                             od.unitprice * od.quantity as ExtendedPrice
                      from [order details] as od} AS rsDetails
                    RELATE orderid TO orderid),
                    SUM(rsDetails.ExtendedPrice) AS OrderTotal) AS rsOrders
   COMPUTE  rsOrders,
            SUM(rsOrders.OrderTotal) AS CustTotal,
            ANY(rsOrders.contactname) AS Contact
   BY       customerid

which yields:

   rsOrders
        |
        +----Customers.*
             orderid
             orderdate
             rsDetails
                  |
                  +----orderid
                       ExtendedPrice
             OrderTotal
   CustomerTotal
   Contact
   customerid

V�rios agrupamentos:

   SHAPE
          (SHAPE  {select customers.*,
                          od.unitprice * od.quantity as ExtendedPrice
                   from (customers inner join orders
                   on customers.customerid = orders.customerid) inner join
                   [order details] as od on orders.orderid = od.orderid}
                          AS rsDetail
           COMPUTE ANY(rsDetail.contactname) AS Contact,
                   ANY(rsDetail.region) AS Region,
                   SUM(rsDetail.ExtendedPrice) AS CustTotal,
                   rsDetail
           BY customerid) AS rsCustSummary
   COMPUTE rsCustSummary
   BY      Region

que produz:

   rsCustSummary
        |
        +-----Contact
              Region
              CustTotal
              rsDetail
                   |
                   +----Customers.*
                        ExtendedPrice
              customerid
   Region

Total geral:

   SHAPE
          (SHAPE  {select customers.*,
                          od.unitprice * od.quantity as ExtendedPrice
                   from (customers inner join orders
                   on customers.customerid = orders.customerid) inner join
                   [order details] as od on orders.orderid = od.orderid}
                          AS rsDetail
           COMPUTE ANY(rsDetail.contactname) AS Contact,
                   SUM(rsDetail.ExtendedPrice) AS CustTotal,
                   rsDetail
           BY customerid) AS rsCustSummary
   COMPUTE SUM(rsCustSummary.CustTotal) As GrandTotal,
           rsCustSummary

Observe a cl�usula BY ausente no resumo externa. Isso define o total principal porque o conjunto de linhas pai cont�m um �nico registro com o total geral e um ponteiro para o conjunto de registros filho.

   GrandTotal
   rsCustSummary
        |
        +-----Contact
              CustTotal
              rsDetail
                  |
                  +----Customers.*
                       ExtendedPrice
              customerid

Hierarquia complexa:

Este exemplo ilustra uma hierarquia que cont�m um conjunto de linhas pai, conjuntos de dois filho linhas, um dos quais � parametrizado, e um detalhe de grupo.

   SHAPE {select customers.* from customers} AS rsDetail
   COMPUTE rsDetail,
           ANY(rsDetail.companyname) AS Company,
           ({select * from orders where customerid = ?}
                   RELATE customerid TO PARAMETER 0) AS rsOrders,
           COUNT(rsOrders.orderid) AS OrderCount
   BY customerid

which yields:

rsDetail
        |
        +----Customers.*
   Company
   rsOrders
        |
        +----Orders.*
   OrderCount
   customerid

Pai agrupado relacionados a filho agrupado:

   SHAPE
          (SHAPE  {select * from customers}
           APPEND ((SHAPE {select orders.*, year(orderdate) as OrderYear,
                                  month(orderdate) as OrderMonth
                           from orders} AS rsOrders
                    COMPUTE rsOrders
                    BY customerid, OrderYear, OrderMonth)
                    RELATE customerid TO customerid) AS rsOrdByMonth )
           AS rsCustomers
   COMPUTE rsCustomers
   BY      region

que produz:

   rsCustomers
        |
        +-----customers.*
              rsOrdByMonth
                 |
                 +-----rsOrders
                            |
                            +---- Orders.*
                       customerid
                       OrderYear
                       OrderMonth
   region

Voltar para o in�cio

Cl�usula de forma gram�tica formal

  <shape-command>      ::=  SHAPE <table-exp> [AS <alias>]
                            [<shape_action>]

  <shape-action>       ::=  APPEND <aliased-field-list>
                            | COMPUTE <aliased-field-list>
                              [BY <field-list>]
                            | BY <field-list>

  <table-exp>          ::=  {<native-sql-statement>}
                            | ( <shape-command> )
 
  <aliased-field-list> ::=  <aliased-field> [, <aliased-field...]
 
  <aliased-field>      ::=  <field-exp> [AS <alias>]
 
  <field-exp>          ::=  ( <relation-exp> ) | <calculated-exp>
 
  <relation_exp>       ::=   <table-exp> [AS <alias>] RELATE
                             <relation-cond-list>
 
  <relation-cond-list> ::=   <relation-cond> [, <relation-cond>...]
 
  <relation-cond>      ::=   <field-name> TO <child-ref>
 
  <child-ref>          ::=   <field-name> | PARAMETER <param-ref>
 
  <param-ref>          ::=   <name> | <number>
 
  <field-list>         ::=   <field-name [, <filed-name>]
 
  <calculated-exp>     ::=   SUM (<qualified-field-name>)
                             | AVG (<qualified-field-name>)
                             | MIN (<qualified-field-name>)
                             | MAX (<qualified-field-name>)
                             | COUNT (<alias>)
                             | SDEV (<qualified-field-name>)
                             | ANY (<qualified-field-name>)
                             | CALC (<expression>)
 
  <qualified-field-name>::=  <alias>.<field-name> | <field-name>
 
  <alias>               ::=  <quoted-name>
 
  <field-name>          ::=  <quoted-name>
 
  <quoted-name>         ::=  "<string>" | '<string>' | <name>
 
  <name>                ::=  alpha [ alpha | digit | _ | # ...]
 
  <number>              ::=  digit [digit...]
 
  <string>              ::=  unicode-char [unicode-char...]
 
  <expression>          ::=  an expression recognized by the Jet
                             Expression service whose operands are
                             other non-CALC columns in the same row.

Voltar para o in�cio

VBA SHAPE Test Program

O programa c�digo VBA a seguir permite que voc� digita em seu pr�prio comando SHAPE e exibir a hierarquia de campo ou indicar o local do erro de sintaxe.

Aviso : USE O c�digo fornecido IN este artigo YOUR pr�prio risco. A Microsoft fornece esse c�digo "como est�o" sem garantia de qualquer tipo, expressa ou impl�cita, inclusive mas n�o limitada �s garantias impl�citas de comercializa��o e/ou adequa��o a uma finalidade espec�fica.

O administrador de ODBC do painel de controle adicione um DSN para o driver ODBC do Microsoft Access 97 chamado OLE_DB_NWIND_JET apontando para o banco de dados Northwind (ou NWIND).
Crie um novo projeto. Adicione duas caixas de texto (Text1 e Text2) e um bot�o de comando (Command1).

Fazer ambas as caixas de texto grandes o suficiente para exibir v�rias linhas de texto e definir as seguintes propriedades:

      Multiline: True                (Visual Basic only)
      Scrollbars: Vertical
      Font: Courier New 10 Point

No menu Project , escolha refer�ncias e adicione uma refer�ncia ao Microsoft ActiveX Data Objects Library.

Adicione o seguinte c�digo:

   Private Sub Command1_Click()
   Dim cn As ADODB.Connection, rs As ADODB.Recordset
     Me!Text2.Text = ""
     Set cn = New ADODB.Connection
     Set rs = New ADODB.Recordset
     cn.Provider = "MSDataShape"
     cn.Open "dsn=OLE_DB_NWIND_JET"
     On Error Resume Next
     rs.Open Me!Text1.Text, cn, adOpenStatic, adLockReadOnly, adCmdText
     If Err Then MsgBox Error
     ListChapteredFields rs, 0
     rs.Close
     cn.Close
     Set rs = Nothing
     Set cn = Nothing
   End Sub

   Private Sub LogText(ByVal sLine As String)
     If Me!Text2.Text = "" Then
       Me!Text2.Text = sLine
     Else
       Me!Text2.Text = Me!Text2.Text & vbCrLf & sLine
     End If
   End Sub

   Private Sub ListChapteredFields(ByVal rs As ADODB.Recordset, _
                                      ByVal Level As Long)
   Dim I As Long
     For I = 0 To rs.Fields.Count - 1
       LogText Space$(Level * 3) & rs(I).Name
       If rs(I).Type = adChapter Then
         ListChapteredFields rs(I).Value, Level + 1
       End If
     Next I
   End Sub

Execute o projeto. Digite o comando SHAPE em Text1, clique no bot�o de comando e a hierarquia � exibido em Text2.

Observa��o : O texto a seguir fornece um exemplo de usando o provedor OLEDB do Microsoft Jet com o provedor SHAPE:

  cn.Provider = "MSDataShape"
  cn.Open "Data Provider=Microsoft.Jet.OLEDB.4.0"

Observa��o : se voc� digita errado nomes de campo ou tabela ao usar o driver ODBC do Access 97 ou JOLT provedores, receber� a seguinte mensagem:

Par�metros insuficientes. N esperado.

Outros provedores podem produzir uma mensagem diferente.

Voltar para o in�cio

Refer�ncias

ADO 2.0 hier�rquicos especifica��o de cursor

Para obter informa��es adicionais sobre sintaxe de APPEND SHAPE e como percorrer conjuntos de registros hier�rquicos, consulte o seguinte artigo na Base de dados de Conhecimento da Microsoft:

185425� (http://support.microsoft.com/kb/185425/EN-US/ ) Conjuntos de registros hier�rquicos por meio de SHAPE APPEND via C + ADO / VBA/Java

Voltar para o in�cio

A informa��o contida neste artigo aplica-se a:

Microsoft ActiveX Data Objects 2.0
Microsoft ActiveX Data Objects 2.1 Service Pack 2
Microsoft ActiveX Data Objects 2.5
Microsoft ActiveX Data Objects 2.6
Microsoft ActiveX Data Objects 2.7

Voltar para o in�cio

kbmt kbdatabase kbhowto kbprovider KB189657 KbMtpt

Voltar para o in�cio

Tradu��o autom�tica

IMPORTANTE: Este artigo foi traduzido por um sistema de tradu��o autom�tica (tamb�m designado por Machine Translation ou MT), n�o tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplica��es (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em portugu�s a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradu��o autom�tica n�o � sempre perfeita, podendo conter erros de vocabul�rio, sintaxe ou gram�tica. A Microsoft n�o � respons�vel por incoer�ncias, erros ou preju�zos ocorridos em decorr�ncia da utiliza��o dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualiza��es freq�entes ao software de tradu��o autom�tica (MT). Obrigado.

Clique aqui para ver a vers�o em Ingl�s deste artigo: 189657� (http://support.microsoft.com/kb/189657/en-us/ )

Voltar para o in�cio

Aviso de Isen��o de Responsabilidade sobre Conte�do do KB Aposentado

Este artigo trata de produtos para os quais a Microsoft n�o mais oferece suporte. Por esta raz�o, este artigo � oferecido "como est�" e n�o ser� mais atualizado.

Voltar para o in�cio

This site in other countries/regions:

Como usar o comando de forma ADO

Nesta p�gina

Sum�rio

Mais Informa��es

Sintaxe simplificada

OBSERVA��ES:

Exemplos

Hierarquia de rela��o simples:

Hierarquia parametrizada:

Composto Relation hierarquia:

Hierarquia de rela��o v�rios:

Hierarquia com agrega��o:

Hierarquia de grupo:

Hierarquia de grupo com agrega��o:

V�rios agrupamentos:

Total geral:

Hierarquia complexa:

Pai agrupado relacionados a filho agrupado:

Cl�usula de forma gram�tica formal

VBA SHAPE Test Program

Refer�ncias

A informa��o contida neste artigo aplica-se a:

Palavras-chave:�

Outros Sites de Suporte

Comunidades

Tradu��es deste artigo