Skip to content

Commit 1457179

Browse files
authored
Merge pull request #195584 from goventur/fix-serverless-sql-self-help
Fix broken link and update content to improve Acrolinx score
2 parents 2d58fba + 9d7ef0e commit 1457179

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

articles/synapse-analytics/sql/resources-self-help-sql-on-demand.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -515,13 +515,13 @@ The field HRESULT contains the result code, below are the most common error code
515515

516516
### [0x80070002](#tab/x80070002)
517517

518-
This error code means the source file is not in storage.
518+
This error code means the source file isn't in storage.
519519

520-
There are reasons why this can happen:
520+
There are reasons why this error code can happen:
521521

522522
- The file was deleted by another application.
523-
- A common scenario: the query execution starts, it enumerates the files and the files are found. Later, during the query execution, a file is deleted (for example by Databricks, Spark or ADF). The query fails because the file is not found.
524-
- This issue can also occur with delta format. The query might succeed on retry because there is a new version of the table and the deleted file is not queried again.
523+
- A common scenario: the query execution starts, it enumerates the files and the files are found. Later, during the query execution, a file is deleted (for example by Databricks, Spark or ADF). The query fails because the file isn't found.
524+
- This issue can also occur with delta format. The query might succeed on retry because there's a new version of the table and the deleted file isn't queried again.
525525

526526
- Invalid execution plan cached
527527
- As a temporary mitigation, run the command `DBCC FREEPROCCACHE`. If the problem persists create a support ticket.
@@ -537,9 +537,9 @@ The error message might also resemble:
537537
File {path} cannot be opened because it does not exist or it is used by another process.
538538
```
539539

540-
- If an Azure AD login has a connection open for more than 1 hour during query execution, any query that relies on Azure AD fails. This includes querying storage using Azure AD pass-through and statements that interact with Azure AD (like CREATE EXTERNAL PROVIDER). This affects tools that keep connections open, like in query editor in SSMS and ADS. Tools that open new connections to execute a query, like Synapse Studio, are not affected.
540+
- If an Azure AD user has a connection open for more than 1 hour during query execution, any query that relies on Azure AD fails, including queries that access storage using Azure AD pass-through authentication, and statements that interact with Azure AD (like CREATE EXTERNAL PROVIDER). This issue frequently affects tools that keep connections open, like in query editor in SSMS and ADS. Tools that open new connections to execute a query, like Synapse Studio, aren't affected.
541541

542-
- Azure AD authentication token might be cached by the client applications. For example Power BI caches Azure Active Directory token and reuses the same token for one hour. The long-running queries might fail if the token expires during execution.
542+
- Azure AD authentication token might be cached by the client applications. For example, Power BI caches Azure Active Directory token and reuses the same token for one hour. The long-running queries might fail if the token expires during execution.
543543

544544
Consider the following mitigations:
545545

@@ -563,7 +563,7 @@ This error message can occur when the serverless SQL pool is experiencing resour
563563
- One serverless SQL pool can concurrently handle 1000 active sessions that are executing lightweight queries, but the numbers will drop if the queries are more complex or scan a larger amount of data. For more information, see [Concurrency limits for Serverless SQL Pool](resources-self-help-sql-on-demand.md#constraints).
564564
- Try reducing the number of queries executing simultaneously or the query complexity.
565565

566-
If the issue is non-transient or you confirmed the problem is not related to high concurrency or query complexity, create a support ticket.
566+
If the issue is non-transient or you confirmed the problem isn't related to high concurrency or query complexity, create a support ticket.
567567

568568

569569
### [0x8007000C](#tab/x8007000C)
@@ -594,11 +594,11 @@ More information about syntax and usage:
594594

595595
### Parquet files
596596

597-
When reading Parquet files, the query will not recover automatically. It needs to be retried by the client application.
597+
When the file format is Parquet, the query won't recover automatically. It needs to be retried by the client application.
598598

599599
### Synapse Link for Dataverse
600600

601-
This error can occur when reading data from Synapse Link for Dataverse, when Synapse Link is syncing data to the lake and the data is being queried at the same time. The product group has a goal to improve this.
601+
This error can occur when reading data from Synapse Link for Dataverse, when Synapse Link is syncing data to the lake and the data is being queried at the same time. The product group has a goal to improve this behavior.
602602

603603

604604
### [0x800700A1](#tab/x800700A1)
@@ -607,22 +607,22 @@ Confirm the storage account accessed is using the "Archive" access tier.
607607

608608
The `archive access` tier is an offline tier. While a blob is in the `archive access` tier, it can't be read or modified.
609609

610-
To read or download a blob in the Archive tier, rehydrate it to an online tier: [Archive access tier](/azure/storage/blobs/access-tiers-overview.md#archive-access-tier)
610+
To read or download a blob in the Archive tier, rehydrate it to an online tier: [Archive access tier](/azure/storage/blobs/access-tiers-overview#archive-access-tier)
611611

612612

613613
### [0x80070057](#tab/x80070057)
614614

615615
This error can occur when the authentication method is User Identity, also known as "Azure AD pass-through" and the Azure Active Directory access token expires.
616616

617-
The error message might also resemble the following:
617+
The error message might also resemble the following pattern:
618618

619619
```
620620
File {path} cannot be opened because it does not exist or it is used by another process.
621621
```
622622

623-
- If an Azure AD login has a connection open for more than 1 hour during query execution, any query that relies on Azure AD fails. This includes querying storage using Azure AD pass-through and statements that interact with Azure AD (like CREATE EXTERNAL PROVIDER). This affects tools that keep connections open, like the query editor in SQL Server Management Studio (SSMS) and ADS. Tools that open new connections to execute a query, like Synapse Studio, are not affected.
623+
- If an Azure AD user has a connection open for more than 1 hour during query execution, any query that relies on Azure AD fails, including queries that access storage using Azure AD pass-through authentication and statements that interact with Azure AD (like CREATE EXTERNAL PROVIDER). This issue frequently affects tools that keep connections open, like the query editor in SQL Server Management Studio (SSMS) and Azure Data Studio (ADS). Client tools that open new connections to execute a query, like Synapse Studio, aren't affected.
624624

625-
- Azure AD authentication token might be cached by the client applications. For example Power BI caches an Azure AD token and reuses it for one hour. The long-running queries might fail if the token expires in the middle of execution.
625+
- Azure AD authentication token might be cached by the client applications. For example, Power BI caches an Azure AD token and reuses it for one hour. The long-running queries might fail if the token expires in the middle of execution.
626626

627627
Consider the following mitigations to resolve the issue:
628628

@@ -635,7 +635,7 @@ Consider the following mitigations to resolve the issue:
635635

636636
### [0x80072EE7](#tab/x80072EE7)
637637

638-
This error code can occur when there is a transient issue in the serverless SQL pool.
638+
This error code can occur when there's a transient issue in the serverless SQL pool.
639639
It happens infrequently and is temporary by nature. Retry the query.
640640

641641
If the issue persists create a support ticket.

0 commit comments

Comments
 (0)