Supporto UTF-8 in OLE DB Driver per SQL Server

Si applica a: SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

Download del driver OLE DB

Microsoft OLE DB Driver for SQL Server (versione 18.2.1) aggiunge il supporto per la codifica server UTF-8. Per informazioni sul supporto della codifica UTF-8 per SQL Server, vedere:

• Regole di confronto e supporto Unicode
• Supporto UTF-8

Nella versione 18.4.0 del driver è stato aggiunto il supporto per la codifica client UTF-8, abilitata con la casella di controllo "Usa Unicode UTF-8 per il supporto linguistico internazionale" in Impostazioni area in Windows 10 e Windows 11.

Inserimento dei dati in una colonna CHAR or VARCHAR con codifica UTF-8

Quando si crea un buffer del parametro di input per l'inserimento, il buffer viene descritto tramite una matrice di strutture DBBINDING. Ogni struttura DBBINDING associa un singolo parametro al buffer del consumer e contiene informazioni come la lunghezza e il tipo del valore dati. Per un buffer del parametro di input di tipo CHAR, il campo wType della struttura DBBINDING deve essere impostato su DBTYPE_STR. Per un buffer del parametro di input di tipo WCHAR, il campo wType della struttura DBBINDING deve essere impostato su DBTYPE_WSTR.

Quando si esegue un comando con i parametri, il driver costruisce informazioni sul tipo di dati dei parametri. Se il tipo di buffer di input e il tipo di dati del parametro corrispondono, non viene eseguita alcuna conversione nel driver. In caso contrario, il driver converte il buffer del parametro di input nel tipo di dati del parametro. Il tipo di dati del parametro può essere impostato in modo esplicito dall'utente chiamando ICommandWithParameters::SetParameterInfo. Se le informazioni non vengono specificate, il driver deriva le informazioni sul tipo di dati del parametro (a) recuperando i metadati della colonna dal server quando viene preparata l'istruzione o (b) tentando una conversione predefinita dal tipo di dati del parametro di input.

Il buffer del parametro di input può essere convertito nelle regole di confronto della colonna server dal driver o dal server a seconda del tipo di dati del buffer di input e del tipo di dati del parametro. Durante la conversione, può verificarsi la perdita dei dati se la tabella codici del client o la tabella codici delle regole di confronto del database non è in grado di rappresentare tutti i caratteri nel buffer di input. La tabella seguente descrive il processo di conversione durante l'inserimento dei dati nella colonna che supporta UTF-8:

Recupero dati da una colonna CHAR or VARCHAR con codifica UTF-8

Quando si crea un buffer per i dati recuperati, il buffer viene descritto tramite una matrice di strutture DBBINDING. Ogni struttura DBBINDING associa una singola colonna nella riga recuperata. Per recuperare i dati della colonna di tipo CHAR, impostare il campo wType della struttura DBBINDING su DBTYPE_STR. Per recuperare i dati della colonna di tipo WCHAR, impostare il campo wType della struttura DBBINDING su DBTYPE_WSTR.

Per l'indicatore del tipo di buffer DBTYPE_STR, il driver converte i dati con codifica UTF-8 nella codifica del client. L'utente deve assicurarsi che la codifica client sia in grado di rappresentare i dati della colonna UTF-8. In caso contrario potrebbe verificarsi la perdita dei dati.

Per l'indicatore del tipo di buffer DBTYPE_WSTR, il driver converte i dati con codifica UTF-8 nella codifica UTF-16.

La comunicazione con i server non supporta UTF-8

Microsoft OLE DB Driver per SQL Server garantisce che i dati vengano esposti al server in un modo comprensibile al server stesso. Quando si inseriscono dati da client abilitati per UTF-8, il driver converte le stringhe con codifica UTF-8 nella tabella codici delle regole di confronto del database prima di inviarle al server.

Vedi anche

Driver OLE DB per funzionalità di SQL Server
Supporto UTF-16 nel driver OLE DB per SQL Server