Alterações de cópia em massa para tipos de data e hora aprimorados (OLE DB e ODBC)
Aplica-se a:
SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)
Este tópico descreve os aprimoramentos de data/hora para oferecer suporte à funcionalidade de cópia em massa. As informações neste tópico são válidas para OLE DB e ODBC no SQL Server Native Client.
Importante
O SQL Server Native Client (geralmente abreviado como SNAC) foi removido do SQL Server 2022 (16.x) e do SSMS (SQL Server Management Studio) 19. O SQL Server Native Client (SQLNCLI ou SQLNCLI11) e o Provedor OLE DB herdado da Microsoft para o SQL Server (SQLOLEDB) não são recomendados para um novo desenvolvimento de aplicativo. Alterne para o novo Driver do Microsoft OLE DB para SQL Server (MSOLEDBSQL) ou o Microsoft ODBC Driver for SQL Server mais recente no futuro. Para SQLNCLI que é fornecido como um componente do Mecanismo de Banco de Dados do SQL Server (versões 2012 a 2019), consulte esta exceção de Ciclo de Vida de Suporte.
Arquivos de formato
Ao criar arquivos de formato interativamente, a tabela a seguir descreve a entrada usada para especificar os tipos de data/hora e os nomes de tipo de dados do arquivo de host correspondentes.
| tipo de armazenamento de arquivo | Tipo de dados do arquivo host | Resposta ao aviso: "Insira o tipo de armazenamento de arquivos do campo <field_name> [<default>]:" |
|---|---|---|
| Datetime | SQLDATETIME | d |
| Smalldatetime | SQLDATETIM4 | D |
| Data | SQLDATE | de |
| Hora | SQLTIME | te |
| Datetime2 | SQLDATETIME2 | d2 |
| Datetimeoffset | SQLDATETIMEOFFSET | do |
O XSD do arquivo de formato XML terá as adições a seguir:
<xs:complexType name="SQLDATETIME2">
<xs:complexContent>
<xs:extension base="bl:Fixed"/>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="SQLDATETIMEOFFSET">
<xs:complexContent>
<xs:extension base="bl:Fixed"/>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="SQLDATE">
<xs:complexContent>
<xs:extension base="bl:Fixed"/>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="SQLTIME">
<xs:complexContent>
<xs:extension base="bl:Fixed"/>
</xs:complexContent>
</xs:complexType>
Arquivos de dados de caracteres
Em arquivos de dados de caracteres, os valores de data e hora são representados conforme descrito na seção "Formatos de dados: cadeias de caracteres e literais" do Suporte a tipos de dados para melhorias de data e hora ODBC para ODBC ou de suporte de tipo de dados para melhorias de data e hora do OLE DB para OLE DB.
Em pulgas de dados nativas, os valores de data e hora para os quatro novos tipos são representados como suas representações de TDS com uma escala de 7 (porque esse é o máximo compatível com SQL Server e os arquivos de dados bcp não armazenam a escala dessas colunas). Não há nenhuma alteração no armazenamento dos tipos datetime e smalldatetime existentes nem em suas representações do protocolo TDS.
Os tamanhos de armazenamento para os diferentes tipos de armazenamento do OLE DB são estes:
| tipo de armazenamento de arquivo | Tamanho de armazenamento em bytes |
|---|---|
| DATETIME | 8 |
| smalldatetime | 4 |
| date | 3 |
| time | 6 |
| datetime2 | 9 |
| datetimeoffset | 11 |
Os tamanhos para o ODBC são mostrados a seguir. Observe que não é necessário armazenar a precisão nem nos arquivos de formato nem nos de dados, porque o BCP.exe sempre recuperará a precisão do servidor.
| tipo de armazenamento de arquivo | Tamanho de armazenamento em bytes | Formato de armazenamento |
|---|---|---|
| datetime (d) | 8 | TDS |
| smalldatetime (D) | 4 | TDS |
| date (de) | 3 | TDS |
| time (te) | 6 | TDS |
| datetime2 (d2) | 9 | TDS |
| datetimeoffset (do) | 11 | TDS |
Tipos BCP em sqlncli.h
Os tipos a seguir são definidos em sqlncli.h para ser usados com as extensões de API BCP para ODBC. Esses tipos são passados com o parâmetro eUserDataType do método IBCPSession::BCPColFmt no OLE DB.
| tipo de armazenamento de arquivo | Tipo de dados do arquivo host | Digite sqlncli.h para uso com IBCPSession::BCPColFmt | Valor |
|---|---|---|---|
| Datetime | SQLDATETIME | BCP_TYPE_SQLDATETIME | 0x3d |
| Smalldatetime | SQLDATETIM4 | BCP_TYPE_SQLDATETIME4 | 0x3a |
| Data | SQLDATE | BCP_TYPE_SQLDATE | 0x28 |
| Hora | SQLTIME | BCP_TYPE_SQLTIME | 0x29 |
| Datetime2 | SQLDATETIME2 | BCP_TYPE_SQLDATETIME2 | 0x2a |
| Datetimeoffset | SQLDATETIMEOFFSET | BCP_TYPE_SQLDATETIMEOFFSET | 0x2b |
Conversões de tipo de dados BCP
As tabelas a seguir fornecem informações de conversão.
Observação do OLE DB As conversões a seguir são executadas por IBCPSession. O IRowsetFastLoad usa conversões OLE DB conforme definido em Conversões realizadas de Cliente para Servidor. Observe que os valores datetime são arredondados para 1/300 de um segundo e os valores smalldatetime têm os segundos definidos como zero depois de concluídas as conversões de cliente descritas a seguir. O arredondamento de datetime se propaga para horas e minutos, mas não para a data.
| Para --> De |
date | time | smalldatetime | DATETIME | datetime2 | datetimeoffset | char | wchar |
|---|---|---|---|---|---|---|---|---|
| Data | 1 | - | 1,6 | 1,6 | 1,6 | 1,5,6 | 1,3 | 1,3 |
| Hora | N/D | 1,10 | 1,7,10 | 1,7,10 | 1,7,10 | 1,5,7,10 | 1,3 | 1,3 |
| Smalldatetime | 1,2 | 1,4,10 | 1 | 1 | 1,10 | 1,5,10 | 1,11 | 1,11 |
| Datetime | 1,2 | 1,4,10 | 1,12 | 1 | 1,10 | 1,5,10 | 1,11 | 1,11 |
| Datetime2 | 1,2 | 1,4,10 | 1,10 (ODBC)1,12 (OLE DB) | 1,10 | 1,10 | 1,5,10 | 1,3 | 1,3 |
| Datetimeoffset | 1,2,8 | 1,4,8,10 | 1,8,10 | 1,8,10 | 1,8,10 | 1,10 | 1,3 | 1,3 |
| Char/wchar (date) | 9 | - | 9,6 (ODBC)9,6,12 (OLE DB) | 9,6 (ODBC)9,6,12 (OLE DB) | 9,6 | 9,5,6 | N/D | N/D |
| Char/wchar (time) | - | 9,10 | 9,7,10 (ODBC)9,7,10,12 (OLE DB) | 9,7,10 (ODBC)9,7,10, 12 (OLE DB) | 9,7,10 | 9,5,7,10 | N/D | N/D |
| Char/wchar (datetime) | 9,2 | 9,4,10 | 9,10 (ODBC)9,10,12 (OLE DB) | 9,10 (ODBC)9,10,12 (OLE DB) | 9,10 | 9,5,10 | N/D | N/D |
| Char/wchar (datetimeoffset) | 9,2,8 | 9,4,8,10 | 9,8,10 (ODBC)9,8,10,12 (OLE DB) | 9,8,10 (ODBC)9,8,10,12 (OLE DB) | 9,8,10 | 9,10 | N/D | N/D |
Legenda dos símbolos
| Símbolo | Significado |
|---|---|
| - | Não há suporte a nenhuma conversão. Será gerado um registro de diagnóstico de ODBC com SQLSTATE 07006 e a mensagem "Violação do atributo de tipo de dados restrito". |
| 1 | Se os dados fornecidos não forem válidos, um registro de diagnóstico ODBC será gerado com SQLSTATE 22007 e a mensagem "Formato de datetime inválido". Para valores datetimeoffset, a parte time deve estar dentro do intervalo após a conversão em UTC, mesmo que nenhuma conversão em UTC seja solicitada. O motivo disso é que o TDS e o servidor sempre normalizam a hora em valores datetimeoffset para UTC. Por isso, o cliente deve verificar se os componentes time estão dentro do intervalo com suporte após a conversão em UTC. |
| 2 | O componente time é ignorado. |
| 3 | Para ODBC, se ocorrer truncamento com perda de dados, um registro de diagnóstico será gerado com SQLSTATE 22001 e a mensagem 'Dados de cadeia de caracteres, truncados à direita' O número de dígitos de segundos fracionários (a escala) é determinado do tamanho da coluna de destino de acordo com a tabela a seguir. Para tamanhos de coluna maiores do que o intervalo na tabela, é sugerida uma escala de 7. Essa conversão deve permitir até nove dígitos de segundos fracionários, o máximo permitido pelo ODBC. Tipo: DBTIME2 Escala implícita 0 8 Escala implícita 1..7 10,16 Tipo: DBTIMESTAMP Escala implícita 0: 19 Escala implícita 1..7: 21..27 Tipo: DBTIMESTAMPOFFSET Escala implícita 0: 26 Escala implícita 1..7: 28..34 Para OLE DB, se ocorrer o truncamento com a perda de dados, será postado um erro. Para datetime2, o número de dígitos de segundos fracionários (a escala) é determinado pelo tamanho da coluna de destino de acordo com a tabela a seguir. Para tamanhos de coluna maiores do que o intervalo na tabela, é sugerida uma escala de 9. Essa conversão deve permitir até nove dígitos de frações de segundo, o máximo permitido pelo OLE DB. Tipo: DBTIME2 Escala implícita 0 8 Escala implícita 1..9 1..9 Tipo: DBTIMESTAMP Escala implícita 0: 19 Escala implícita 1..9: 21..29 Tipo: DBTIMESTAMPOFFSET Escala implícita 0: 26 Escala implícita 1..9: 28..36 |
| 4 | O componente de data é ignorado. |
| 5 | O timezone é definido como UTC (por exemplo, 00:00). |
| 6 | A hora é definida como zero. |
| 7 | O componente date é definido como 1900-01-01. |
| 8 | O deslocamento de timezone é ignorado. |
| 9 | A cadeia de caracteres é analisada e convertida em um valor date, datetime, datetimeoffset ou time, dependendo do primeiro caractere de pontuação encontrado e da presença dos componentes restantes. A cadeia de caracteres é convertida no tipo de destino, seguindo as regras na tabela ao final deste tópico para o tipo de origem descoberto por esse processo. Se não for possível analisar sem erro os dados fornecidos ou se qualquer parte do componente estive fora do intervalo permitido ou ainda se não houver nenhuma conversão do tipo literal para o tipo de destino, será postado um erro (OLE DB) ou gerado um registro de diagnóstico de ODBC com SQLSTATE 22018 e a mensagem "Valor de caractere inválido para a especificação de difusão". Para os parâmetros datetime e smalldatetime, se o ano estiver fora do intervalo com suporte nesses tipos, será postado um erro (OLE DB) ou gerado um registro de diagnóstico de ODBC com SQLSATE 22007 e a mensagem "Formato de datetime inválido". Para datetimeoffset, o valor deve estar dentro do intervalo após a conversão em UTC, mesmo que nenhuma conversão em UTC seja solicitada. O motivo disso é que o TDS e o servidor sempre normalizam a hora em valores datetimeoffset para UTC, por isso o cliente deve verificar se os componentes time estão dentro do intervalo com suporte após a conversão em UTC. Se o valor não estiver dentro do intervalo UTC com suporte, será postado um erro (OLE DB) ou gerado um registro de diagnóstico de ODBC com SQLSTATE 22007 e a mensagem "Formato de datetime inválido". |
| 10 | Se ocorrer o truncamento com a perda de dados em uma conversão de cliente para servidor, será postado um erro (OLE DB) ou gerado um registro de diagnóstico de ODBC com SQLSTATE 22008 e a mensagem "Estouro no campo de data e hora". Esse erro também ocorrerá se o valor estiver fora do intervalo que pode ser representado pelo intervalo UTC usado pelo servidor. Se ocorrer o truncamento de segundos ou de segundos fracionários em uma conversão de cliente para servidor, somente um aviso será emitido. |
| 11 | Se ocorrer o truncamento com a perda de dados, será gerado um registro de diagnóstico. Em uma conversão de servidor para cliente, isso é uma advertência (ODBC SQLSTATE S1000). Em uma conversão de cliente para servidor, isso é um erro (ODBC SQLSTATE 22001). |
| 12 | Os segundos são definidos como zero e os segundos fracionários são descartados. Nenhum erro de truncamento é possível. |
| N/D | O SQL Server 2005 (9.x) existente e o comportamento anterior é mantido. |
Consulte Também
Aprimoramentos de data e hora (ODBC)
Melhorias de data e hora (OLE DB)
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de