Problemi noti di Azure Synapse Analytics

In questa pagina sono elencati i problemi noti di Azure Synapse Analytics e la data di risoluzione o la possibile soluzione alternativa. Prima di inviare una richiesta di supporto tecnico di Azure, consultare questo elenco per verificare se il problema riscontrato è già noto e in fase di risoluzione.

Per altre informazioni su Azure Synapse Analytics, vedere la panoramica di Azure Synapse Analytics e Novità di Azure Synapse Analytics.

Problemi noti attivi

Componente Azure Synapse Status Problema
Pool SQL dedicato di Azure Synapse I clienti non sono in grado di monitorare l'utilizzo del pool SQL dedicato usando le metriche Ha una soluzione alternativa
Pool SQL dedicato di Azure Synapse Errore della query durante l'inserimento di un file Parquet in una tabella con AUTO_CREATE_TABLE='ON' Ha una soluzione alternativa
Pool SQL dedicato di Azure Synapse Errore delle query con errore di esfiltrazione di dati Ha una soluzione alternativa
Pool SQL dedicato di Azure Synapse L'istruzione UPDATE STATISTICS ha esito negativo e viene visualizzato l'errore "Il flusso delle statistiche è danneggiato". Ha una soluzione alternativa
Pool SQL serverless di Azure Synapse Errori delle query dal pool SQL serverless all'archivio analitico di Azure Cosmos DB Ha una soluzione alternativa
Pool SQL serverless di Azure Synapse La visualizzazione dell'archivio analitico di Azure Cosmos DB propaga attributi errati nella colonna Ha una soluzione alternativa
Pool SQL serverless di Azure Synapse Errori delle query nei pool SQL serverless Ha una soluzione alternativa
Pool SQL serverless di Azure Synapse Problemi di accesso all'archiviazione a causa di un'intestazione di autorizzazione troppo lunga Ha una soluzione alternativa
Pool SQL serverless di Azure Synapse L'esecuzione di query relative a una visualizzazione genera risultati imprevisti Ha una soluzione alternativa
Area di lavoro di Azure Synapse Il servizio collegato dell'archivio BLOB con l'identità gestita assegnata dall'utente non viene elencato Ha una soluzione alternativa
Area di lavoro di Azure Synapse Non è stato possibile eliminare l'area di lavoro di Synapse e non è possibile eliminare la rete virtuale Ha una soluzione alternativa
Area di lavoro di Azure Synapse Le operazioni PUT dell'API REST o i modelli di Azure Resource Manager/Bicep per aggiornare le impostazioni di rete hanno esito negativo Ha una soluzione alternativa
Area di lavoro di Azure Synapse Problema noto che incorpora parentesi quadre [] nel valore dei tag Ha una soluzione alternativa
Area di lavoro di Azure Synapse Errori di distribuzione nell'area di lavoro di Synapse con l'uso di Synapse-workspace-deployment v1.8.0 nelle azioni GitHub con modelli di Resource Manager Ha una soluzione alternativa
Area di lavoro di Azure Synapse Nessuna GET operazione API dedicata all'Microsoft.Synapse/workspaces/trustedServiceBypassEnabledimpostazione Ha una soluzione alternativa

Riepilogo dei problemi noti attivi del pool SQL dedicato di Azure Synapse Analytics

I clienti non sono in grado di monitorare l'utilizzo del pool SQL dedicato usando le metriche

Un aggiornamento interno della logica di emissione dei dati di telemetria, progettato per migliorare le prestazioni e l'affidabilità dei dati di telemetria, ha causato un problema imprevisto che ha interessato la capacità di alcuni clienti di monitorare il pool SQL dedicato, tempdb, e le metriche di I/O dei dati di Data Warehouse.

Soluzione alternativa: al momento dell'identificazione del problema, il team ha adottato un'azione per identificare la causa radice e aggiornare la configurazione nel sistema. I clienti possono risolvere il problema sospendo e riprendendo l'istanza, ripristinando lo stato normale dell'istanza e il flusso di dati di telemetria.

Errore della query durante l'inserimento di un file Parquet in una tabella con AUTO_CREATE_TABLE='ON'

I clienti che tentano di inserire un file Parquet in una tabella con distribuzione hash con AUTO_CREATE_TABLE='ON' possono ricevere l'errore seguente:

COPY statement using Parquet and auto create table enabled currently cannot load into hash-distributed tables

L'inserimento in una tabella con distribuzione hash creata automaticamente che usa AUTO_CREATE_TABLE non è supportato. I clienti che in precedenza hanno caricato questo scenario non supportato devono eseguire un'operazione CTAS sui loro dati in una nuova tabella e usarli al posto della tabella precedente.

Errore delle query con errore di esfiltrazione di dati

Le aree di lavoro di Synapse create partendo da un pool SQL dedicato esistente segnalano un errore della query correlata a Protezione esfiltrazione dati con messaggio di errore generico mentre Protezione esfiltrazione dati è disattivata in Synapse Analytics:

Data exfiltration to '{****}' is blocked. Add destination to allowed list for data exfiltration and try again.

Soluzione alternativa: se si è verificato un errore simile, contattare il team di supporto tecnico Microsoft per ricevere assistenza.

Errore UPDATE STATISTICS

Alcuni pool SQL dedicati possono riscontrare un'eccezione durante l'esecuzione di un'istruzione UPDATE STATISTICS. Il comando restituisce il messaggio "Il flusso delle statistiche è danneggiato" e non aggiorna le statistiche.

Quando viene aggiunto un nuovo vincolo a una tabella, viene creata una statistica correlata nelle distribuzioni. Se viene creato anche un indice cluster nella tabella, deve includere le stesse colonne del vincolo (nello stesso ordine). In caso contrario, i comandi di UPDATE STATISTICS su tali colonne potrebbero avere esito negativo.

Soluzione alternativa: identificare se esistono un vincolo e un indice cluster nella tabella. In caso affermativo, RIMUOVERE sia il vincolo che l'indice cluster. Successivamente, ricreare l'indice cluster e quindi il vincolo assicurandosi che entrambi includano le stesse colonne nello stesso ordine. Se la tabella non ha un vincolo e un indice cluster o se il passaggio precedente genera lo stesso errore, contattare il team di supporto tecnico Microsoft per ricevere assistenza.

Gli aggiornamenti dei tag sembrano avere esito negativo

Quando si apporta una modifica ai tag di un pool SQL dedicato tramite il portale di Azure o altri metodi, può essere visualizzato un messaggio di errore anche se la modifica viene apportata correttamente.

Soluzione alternativa: è possibile verificare che la modifica ai tag abbia avuto esito positivo e ignorare/eliminare il messaggio di errore in base alle esigenze.

Riepilogo dei problemi noti attivi dell'area di lavoro di Azure Synapse

Di seguito sono descritti i problemi noti relativi all'area di lavoro di Synapse.

Il servizio collegato dell'archivio BLOB con l'identità gestita assegnata dall'utente non viene elencato

Il servizio collegato potrebbe non essere visibile in Hub dati ->Collegato ->Archiviazione BLOB di Azure dopo la configurazione del servizio collegato dell'archivio BLOB per usare l'autenticazione "Identità gestita assegnata dall'utente" in Azure Synapse Analytics.

Soluzione alternativa: il team di progettazione è attualmente a conoscenza di questo comportamento e sta lavorando a una correzione. In alternativa, usare il metodo di autenticazione "Identità gestita assegnata dal sistema" anziché "Identità gestita assegnata dall'utente".

Non è stato possibile eliminare l'area di lavoro di Synapse e non è possibile eliminare la rete virtuale

L'eliminazione di un'area di lavoro di Synapse ha esito negativo e viene visualizzato il messaggio di errore:

Failed to delete Synapse workspace '[Workspace Name]'. Unable to delete virtual network. The correlationId is ********-****-****-****-************;

Soluzione alternativa: il problema può essere mitigato ritentando l'operazione di eliminazione. Il team di progettazione è a conoscenza di questo comportamento e sta lavorando a una correzione.

Le operazioni PUT dell'API REST o i modelli di Azure Resource Manager/Bicep per aggiornare le impostazioni di rete hanno esito negativo

Quando si usa un modello di Resource Manager, un modello Bicep o un'operazione PUT diretta dell'API REST per modificare le impostazioni di accesso alla rete pubblica e/o le regole del firewall per un'area di lavoro di Synapse, l'operazione può avere esito negativo.

Soluzione alternativa: il problema può essere mitigato usando un'operazione PATCH dell'API REST o l'interfaccia utente del portale di Azure per annullare e ripetere le modifiche di configurazione desiderate. Il team di progettazione è a conoscenza di questo comportamento e sta lavorando a una correzione.

Problema noto che incorpora parentesi quadre [] nel valore dei tag

Nel contesto dell'aggiornamento dei valori dei tag all'interno di un'area di lavoro di Azure Synapse, l'inclusione di parentesi quadre ([]) comporterà l'esito negativo di un'operazione di aggiornamento.

Soluzione alternativa: la soluzione alternativa corrente consiste nell'evitare di usare le parentesi quadre ([]) nei valori dei tag dell'area di lavoro di Azure Synapse.

Errori di distribuzione nell'area di lavoro di Synapse con l'uso di Synapse-workspace-deployment v1.8.0 nelle azioni GitHub con modelli di Resource Manager

L'errore si verifica durante la distribuzione all'ambiente di produzione ed è correlato a un trigger che contiene un nome host con una doppia barra rovesciata.

Il messaggio di errore visualizzato è Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057.

Soluzione alternativa: come mitigazione rapida è possibile eseguire le azioni seguenti:

  • Rimuovere caratteri di escape: rimuovere manualmente i caratteri di escape (\) dal file dei parametri prima della distribuzione. Questo significa modificare il file per eliminare i caratteri che potrebbero causare problemi durante la fase di analisi o elaborazione della distribuzione.
  • Sostituire caratteri di escape con barre: sostituire i caratteri di escape (\) con barre (/). Questo può essere particolarmente utile nei percorsi di file, in cui molti sistemi accettano le barre come separatori di percorso validi. Questa sostituzione potrebbe aiutare a ignorare il problema con i caratteri di escape, consentendo al processo di distribuzione di avere esito positivo.

Dopo aver applicato una di queste soluzioni alternative e aver eseguito correttamente la distribuzione, aggiornare manualmente le configurazioni necessarie all'interno dell'area di lavoro per assicurarsi che tutto sia configurato correttamente. Questo potrebbe comportare la modifica dei file di configurazione, la modifica delle impostazioni o l'esecuzione di altre attività rilevanti per l'ambiente specifico o l'applicazione in fase di distribuzione.

Nessuna operazione API 'GET' dedicata all'impostazione "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled"

Riepilogo dei problemi: in Azure Synapse Analytics non esiste alcuna operazione API 'GET' dedicata per recuperare lo stato dell'impostazione "trustedServiceBypassEnabled" nell'ambito della risorsa "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled". Anche se gli utenti possono impostare questa configurazione, non possono recuperarne direttamente lo stato tramite questo ambito di risorsa specifico.

Impatto: questa limitazione influisce sulle definizioni di Criteri di Azure, perché non possono applicare uno stato specifico per l'impostazione "trustedServiceBypassEnabled". I clienti non possono usare Criteri di Azure per negare o gestire questa configurazione.

Soluzione alternativa: in Criteri di Azure non è disponibile alcuna soluzione alternativa per applicare lo stato di configurazione desiderato per questa proprietà. Tuttavia, gli utenti possono usare l'operazione 'GET' dell'area di lavoro per controllare lo stato di configurazione a scopo di creazione di report.
Questa operazione dell'area di lavoro 'GET' è mappata all'alias di Criteri di Azure "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled".

L'alias di Criteri di Azure può essere usato per la gestione di questa proprietà con un effetto Nega criteri di Azure se l'operazione è una richiesta PUT per la risorsa microsoft.Synapse/workspace, ma funzionerà solo a scopo di controllo se la richiesta PUT viene inviata direttamente alla risorsa figlio Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration. La risorsa padre ha una proprietà [properties.trustedServiceBypassEnabled] che esegue il mapping della configurazione dalla risorsa figlio ed è per questo motivo che può comunque essere controllato tramite l'alias di Criteri di Azure della risorsa padre.

Poiché la risorsa figlio Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration non dispone di alcuna operazione GET, Criteri di Azure non può gestire queste richieste e Criteri di Azure non può generare un alias di Criteri di Azure per tale risorsa.

Risorsa padre: Microsoft.Synapse/workspaces

Risorsa figlio: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration

Il portale di Azure effettua la richiesta PUT direttamente all'API PUT per la risorsa figlio e pertanto il portale di Azure, insieme a qualsiasi altra richiesta API effettuata all'esterno delle API Microsoft.Synapse/workspaces padre, non può essere gestita da Criteri di Azure tramite un effetto Nega o altri criteri di Azure interattivi.

Riepilogo dei problemi noti attivi del pool SQL serverless di Azure Synapse Analytics

Errore delle query dal pool SQL serverless all'archivio analitico di Azure Cosmos DB

Le query da un pool SQL serverless a un archivio analitico di Azure Cosmos DB potrebbero avere esito negativo e presentare uno dei messaggi di errore seguenti:

  • Resolving CosmosDB path has failed with error 'This request is not authorized to perform this operation'
  • Resolving CosmosDB path has failed with error 'Key not found'

Le condizioni seguenti devono essere vere per confermare questo problema:

  1. La connessione all'archivio analitico di Azure Cosmos DB usa un endpoint privato.
  2. Il nuovo tentativo di eseguire la query ha esito positivo.

Soluzione alternativa: il team di progettazione è a conoscenza di questo comportamento ed è possibile eseguire come mitigazione rapida le azioni seguenti:

  1. Riprovare la query con esito negativo. Verrà aggiornato automaticamente il token scaduto.
  2. Disabilitare l'endpoint privato. Prima di applicare questa modifica, verificare con il team di sicurezza che soddisfi i criteri di sicurezza aziendali.

La visualizzazione dell'archivio analitico di Azure Cosmos DB propaga attributi errati nella colonna

Quando si usano viste nel pool serverless di Azure Synapse sull'archivio analitico di Cosmos DB, se si verifica una modifica ai file nell'archivio analitico di Cosmos DB, la modifica non viene propagata correttamente alle istruzioni SELECT che il cliente sta usando nella vista. Di conseguenza, gli attributi vengono mappati in modo non corretto a una colonna diversa nei risultati.

Soluzione alternativa: il team di progettazione è a conoscenza di questo comportamento ed è possibile eseguire come mitigazione rapida le azioni seguenti:

  1. Ricreare la vista rinominando le colonne.
  2. Se possibile, evitare di usare le viste.

La modifica delle credenziali con ambito database ha esito negativo se sono state usate le credenziali

In alcuni casi potrebbe non essere possibile eseguire la query ALTER DATABASE SCOPED CREDENTIAL. La causa radice di questo problema è che le credenziali sono state memorizzate nella cache dopo il primo uso, il che le rende inaccessibili per la modifica. Il codice di errore restituito è:

  • Failed to modify the identity field of the credential '{credential_name}' because the credential is used by an active database file.

Soluzione alternativa: il team di progettazione è attualmente a conoscenza di questo comportamento e sta lavorando a una correzione. Come soluzione alternativa è possibile RIMUOVERE e CREARE le credenziali, il che significherebbe anche ricreare tabelle esterne usando le credenziali. In alternativa, è possibile contattare il team di supporto tecnico Microsoft per ricevere assistenza.

Errori delle query nei pool SQL serverless

La scadenza del token può causare errori durante l'esecuzione della query anche se dispone delle autorizzazioni necessarie per l'utente sull'archiviazione. Questi messaggi di errore possono verificarsi anche a causa di errori utente comuni, ad esempio quando i ruoli di controllo degli accessi in base al ruolo non vengono assegnati all'account di archiviazione.

Messaggi di errore di esempio:

  • WaitIOCompletion call failed. HRESULT = 0x80070005'. File/External table name: {path}
  • Unable to resolve path '%' Error number 13807, Level 16, State 1, Message "Content of directory on path '%' cannot be listed.
  • Error 16561: External table '<table_name>' is not accessible because content of directory cannot be listed.
  • Error 13822: File {path} cannot be opened because it does not exist or it is used by another process.
  • Error 16536: Cannot bulk load because the file "%ls" could not be opened.

Soluzione alternativa:

La risoluzione è diversa a seconda dell'autenticazione, Microsoft Entra (in precedenza Azure Active Directory) o identità del servizio gestito:

Per la scadenza del token di Microsoft Entra:

Per la scadenza del token dell'identità del servizio gestito:

  • Disattivare quindi attivare il pool per cancellare la cache dei token. Contattare il team di supporto tecnico Microsoft per assistenza.

Problemi di accesso all'archiviazione a causa di un'intestazione di autorizzazione troppo lunga

Messaggi di errore di esempio nei pool SQL serverless:

  • File {path} cannot be opened because it does not exist or it is used by another process.
  • Content of directory on path {path} cannot be listed.
  • WaitIOCompletion call failed. HRESULT = {code}'. File/External table name: {path}

Questi errori di accesso all'archiviazione generici vengono visualizzati durante l'esecuzione di una query. Il problema potrebbe verificarsi per un utente in un'area di lavoro, ma funziona correttamente in altre aree di lavoro. Questo comportamento è previsto a causa delle dimensioni del token.

Controllare la lunghezza del token Microsoft Entra eseguendo il comando seguente in PowerShell. Il valore del parametro -ResourceUrl sarà differente per i cloud non pubblici. Se la lunghezza del token è vicina a 11000 o superiore, vedere la sezione Mitigazione.

(Get-AzAccessToken -ResourceUrl https://database.windows.net).Token.Length

Soluzione alternativa:

Le soluzioni alternative suggerite sono:

  • Passare all'autorizzazione di archiviazione di Identità gestita come descritto nel controllo di accesso alla risorsa di archiviazione.
  • Ridurre il numero di gruppi di sicurezza (con 90 o meno gruppi di sicurezza con un token di lunghezza compatibile).
  • Aumentare il numero di gruppi di sicurezza su 200 (in quanto cambia il modo in cui viene costruito il token, conterrà un URI dell'API Microsoft Graph anziché un elenco completo di gruppi). È possibile ottenerlo aggiungendo gruppi fittizi/artificiali seguendo gruppi gestiti, dopodiché è necessario aggiungere utenti ai gruppi appena creati.

L'esecuzione di query relative a una visualizzazione genera risultati imprevisti

Quando si esegue una query relativa a una visualizzazione il cui schema sottostante è stato modificato dopo la creazione della visualizzazione, possono verificarsi risultati imprevisti. Questo significa che la visualizzazione fa riferimento a colonne oppure a oggetti modificati o che non esistono più. Per risolvere il problema, è necessario modificare manualmente la definizione della visualizzazione in modo che sia allineata alle modifiche dello schema sottostante.

Soluzione alternativa: modificare manualmente la definizione della visualizzazione.

Problemi noti chiusi di recente

Riepilogo dei problemi noti chiusi di recente del pool SQL serverless di Azure Synapse Analytics

Le query che usano l'autenticazione di Microsoft Entra hanno esito negativo dopo 1 ora

Le connessioni SQL che usano l'autenticazione di Microsoft Entra che rimangono attive per più di 1 ora iniziano ad avere esito negativo. Sono incluse l'esecuzione di query sull'archiviazione tramite l'autenticazione pass-through di Microsoft Entra e le istruzioni che interagiscono con Microsoft Entra ID, ad esempio CREATE EXTERNAL PROVIDER. Ciò influisce su tutti gli strumenti che mantengono attive le connessioni, ad esempio l'editor di query in SSMS e ADS. Gli strumenti che aprono una nuova connessione per eseguire query, ad esempio Synapse Studio, non sono interessati.

Stato: risolto

Errori di query durante la lettura dei dati di Azure Cosmos DB con OPENROWSET

Le query dal pool SQL serverless all'archivio analitico di Cosmos DB con OPENROWSET hanno esito negativo e viene visualizzato il messaggio di errore seguente:

Resolving CosmosDB path has failed with error 'bad allocation'.

Stato: risolto

Riepilogo dei problemi noti chiusi di recente del pool di Apache Spark di Azure Synapse Analytics

Non è stato possibile scrivere al pool SQL dedicato da Synapse Spark usando il Connettore del pool SQL dedicato di Azure Synapse per Apache Spark durante l'uso di notebook nelle pipeline

Non è stato possibile scrivere al pool SQL dedicato da Synapse Spark usando il connettore del pool SQL dedicato di Azure Synapse per Apache Spark durante l'uso di notebook nelle pipeline:

com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: COPY statement input file schema discovery failed: Cannot bulk load. The file does not exist or you don't have file access rights.

Stato: risolto

Alcuni processi o attività Spark hanno esito negativo troppo presto e viene visualizzato il codice errore 503 a causa della limitazione della larghezza di banda dell'account di archiviazione

Tra il 3 ottobre e il 16 novembre 2023, alcuni pool di Apache Spark di Azure Synapse Analytics potrebbero aver riscontrato errori di processi/attività Spark a causa del superamento della soglia del limite dell'API di archiviazione.

Stato: risolto

Errore della query con una clausola LIKE quando si usa il connettore del pool SQL dedicato di Synapse nel runtime di Spark 3.4

Apache Spark 3.4 open source include un problema relativo all'escape dei caratteri speciali, ma Synapse SQL non supporta la parola chiave ESCAPE. Quando i clienti usano il connettore del pool SQL dedicato di Azure Synapse per Apache Spark, può generare una query SQL non valida per Synapse SQL e il notebook o il processo batch di Synapse Spark genera un errore simile al seguente:

com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: com.microsoft.sqlserver.jdbc.SQLServerException: Parse error at line: 1, column: XXX: Incorrect syntax near ''%test%''

Stato: risolto