Skip to content

Commit 3b600ca

Browse files
Merge pull request #293004 from Lucky-Wang16/0114-Update_TSG_link
[Doc update] Update TSG overview section name
2 parents 75571ea + 2468ec0 commit 3b600ca

File tree

2 files changed

+33
-62
lines changed

2 files changed

+33
-62
lines changed

articles/data-factory/connector-troubleshoot-guide.md

Lines changed: 30 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how to troubleshoot connector issues in Azure Data Factory an
55
author: jianleishen
66
ms.subservice: data-movement
77
ms.topic: troubleshooting
8-
ms.date: 09/25/2024
8+
ms.date: 01/14/2025
99
ms.author: jianleishen
1010
ms.custom: synapse
1111
ai-usage: ai-assisted
@@ -44,8 +44,7 @@ You can refer to the troubleshooting pages for each connector to see problems sp
4444

4545
The following errors are general to the copy activity and could occur with any connector.
4646

47-
<a name="error-code-usererrorodbcoperationFailed"></a>
48-
#### Error code: 2200 - UserErrorOdbcOperationFailed
47+
#### <a name="error-code-usererrorodbcoperationfailed"></a> Error code: 2200 - UserErrorOdbcOperationFailed
4948

5049
- **Message**: `The underlying connection was closed: An unexpected error occurred on a send.`
5150

@@ -56,25 +55,23 @@ The following errors are general to the copy activity and could occur with any c
5655
- Check the authentication method used for the connection.
5756
- Review firewall configuration settings for Azure Cosmos DB to ensure they allow the necessary traffic.
5857

59-
<a name="error-code-jrenotfound"></a>
60-
#### Error code: 20000 - JreNotFound
58+
#### <a name="error-code-jrenotfound"></a> Error code: 20000 - JreNotFound
6159

6260
- **Message**: `Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.`
6361

6462
- **Cause**: The self-hosted IR can't find Java Runtime. Java Runtime is required for reading particular sources.
6563

6664
- **Recommendation**: Check your integration runtime environment, see [Use Self-hosted Integration Runtime](./format-parquet.md#using-self-hosted-integration-runtime).
6765

68-
#### Error code: 20002
66+
#### <a name="error-code-jniexception"></a> Error code: 20002 - JniException
6967

7068
- **Message**: `An error occurred when invoking Java Native Interface.`
7169

7270
- **Cause**: If the error message contains "Can't create JVM: JNI return code [-6][JNI call failed: Invalid arguments.]," the possible cause is that JVM can't be created because some illegal (global) arguments are set.
7371

7472
- **Recommendation**: Sign in to the machine that hosts *each node* of your self-hosted integration runtime. Check to ensure that the system variable is set correctly, as follows: `_JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G`. Restart all the integration runtime nodes, and then rerun the pipeline.
7573

76-
<a name="error-code-wildcardpathsinknotsupported"></a>
77-
#### Error code: 20020 - WildcardPathSinkNotSupported
74+
#### <a name="error-code-wildcardpathsinknotsupported"></a> Error code: 20020 - WildcardPathSinkNotSupported
7875

7976
- **Message**: `Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.`
8077

@@ -101,51 +98,45 @@ The following errors are general to the copy activity and could occur with any c
10198

10299
3. Save the file, and then restart the Self-hosted IR machine.
103100

104-
<a name="error-code-jniexception"></a>
105-
#### Error code: 20150 - JniException
101+
#### <a name="error-code-getoauth2accesstokenerrorresponse"></a> Error code: 20150 - GetOAuth2AccessTokenErrorResponse
106102

107103
- **Message**: `Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.`
108104

109105
- **Cause**: Your client ID or client secret is invalid, and the authentication failed in your authorization server.
110106

111107
- **Recommendation**: Correct all OAuth2 client credential flow settings of your authorization server.
112108

113-
<a name="error-code-failedtogetoauth2accesstoken"></a>
114-
#### Error code: 20151 - FailedToGetOAuth2AccessToken
109+
#### <a name="error-code-failedtogetoauth2accesstoken"></a> Error code: 20151 - FailedToGetOAuth2AccessToken
115110

116111
- **Message**: `Failed to get access token from your token endpoint. Error message: %errorMessage;.`
117112

118113
- **Cause**: OAuth2 client credential flow settings are invalid.
119114

120115
- **Recommendation**: Correct all OAuth2 client credential flow settings of your authorization server.
121116

122-
<a name="error-code-<a name="error-code-oauth2accesstokentypenotsupported"></a>
123-
#### Error code: 20152 - OAuth2AccessTokenTypeNotSupported
117+
#### <a name="error-code-oauth2accesstokentypenotsupported"></a> Error code: 20152 - OAuth2AccessTokenTypeNotSupported
124118

125119
- **Message**: `The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.`
126120

127121
- **Cause**: Your authorization server isn't supported.
128122

129123
- **Recommendation**: Use an authorization server that can return tokens with supported token types.
130-
-
131-
<a name="error-code-<a name="error-code-oauth2clientidcolonnotallowed"></a>
132-
#### Error code: 20153 - OAuth2ClientIdColonNotAllowed
124+
125+
#### <a name="error-code-oauth2clientidcolonnotallowed"></a> Error code: 20153 - OAuth2ClientIdColonNotAllowed
133126

134127
- **Message**: `The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.`
135128

136129
- **Cause**: Your client ID includes the invalid character colon (`:`).
137130

138131
- **Recommendation**: Use a valid client ID.
139132

140-
<a name="error-code-ManagedIdentityCredentialObjectNotSupported"></a>
141-
#### Error code: 20523 - ManagedIdentityCredentialObjectNotSupported
133+
#### <a name="error-code-managedidentitycredentialobjectnotsupported"></a> Error code: 20523 - ManagedIdentityCredentialObjectNotSupported
142134

143135
- **Message**: `Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.`
144136

145137
- **Recommendation**: Check the supported version and upgrade the integration runtime to a higher version.
146138

147-
<a name="error-code-QueryMissingFormatSettingsInDataset"></a>
148-
#### Error code: 20551 - QueryMissingFormatSettingsInDataset
139+
#### <a name="error-code-querymissingformatsettingsindataset"></a> Error code: 20551 - QueryMissingFormatSettingsInDataset
149140

150141
- **Message**: `The format settings are missing in dataset %dataSetName;.`
151142

@@ -157,115 +148,99 @@ The following errors are general to the copy activity and could occur with any c
157148

158149
- **Recommendation**: Deselect the "Binary copy" in the dataset, and set correct format settings.
159150

160-
<a name="error-code-QueryUnsupportedCommandBehavior"></a>
161-
#### Error code: 20552 - QueryUnsupportedCommandBehavior
151+
#### <a name="error-code-queryunsupportedcommandbehavior"></a> Error code: 20552 - QueryUnsupportedCommandBehavior
162152

163153
- **Message**: `The command behavior "%behavior;" is not supported.`
164154

165155
- **Recommendation**: Don't add the command behavior as a parameter for preview or GetSchema API request URL.
166156

167-
<a name="error-code-DataConsistencyFailedToGetSourceFileMetadata"></a>
168-
#### Error code: 20701 - DataConsistencyFailedToGetSourceFileMetadata
157+
#### <a name="error-code-dataconsistencyfailedtogetsourcefilemetadata"></a> Error code: 20701 - DataConsistencyFailedToGetSourceFileMetadata
169158

170159
- **Message**: `Failed to retrieve source file ('%name;') metadata to validate data consistency.`
171160

172161
- **Cause**: There's a transient issue on the sink data store, or retrieving metadata from the sink data store isn't allowed.
173162

174-
<a name="error-code-DataConsistencyFailedToGetSinkFileMetadata"></a>
175-
#### Error code: 20703 - DataConsistencyFailedToGetSinkFileMetadata
163+
#### <a name="error-code-dataconsistencyfailedtogetsinkfilemetadata"></a> Error code: 20703 - DataConsistencyFailedToGetSinkFileMetadata
176164

177165
- **Message**: `Failed to retrieve sink file ('%name;') metadata to validate data consistency.`
178166

179167
- **Cause**: There's a transient issue on the sink data store, or retrieving metadata from the sink data store isn't allowed.
180168

181-
<a name="error-code-DataConsistencyValidationNotSupportedForNonDirectBinaryCopy"></a>
182-
#### Error code: 20704 - DataConsistencyValidationNotSupportedForNonDirectBinaryCopy
169+
#### <a name="error-code-dataconsistencyvalidationnotsupportedfornondirectbinarycopy"></a> Error code: 20704 - DataConsistencyValidationNotSupportedForNonDirectBinaryCopy
183170

184171
- **Message**: `Data consistency validation is not supported in current copy activity settings.`
185172

186173
- **Cause**: The data consistency validation is only supported in the direct binary copy scenario.
187174

188175
- **Recommendation**: Remove the 'validateDataConsistency' property in the copy activity payload.
189176

190-
<a name="error-code-DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime"></a>
191-
#### Error code: 20705 - DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
177+
#### <a name="error-code-dataconsistencyvalidationnotsupportedforlowversionselfhostedintegrationruntime"></a> Error code: 20705 - DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
192178

193179
- **Message**: `'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.`
194180

195181
- **Recommendation**: Check the supported integration runtime version and upgrade it to a higher version, or remove the 'validateDataConsistency' property from copy activities.
196182

197-
<a name="error-code-SkipMissingFileNotSupportedForNonDirectBinaryCopy"></a>
198-
#### Error code: 20741 - SkipMissingFileNotSupportedForNonDirectBinaryCopy
183+
#### <a name="error-code-skipmissingfilenotsupportedfornondirectbinarycopy"></a> Error code: 20741 - SkipMissingFileNotSupportedForNonDirectBinaryCopy
199184

200185
- **Message**: `Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.`
201186

202187
- **Recommendation**: Remove 'fileMissing' of the skipErrorFile setting in the copy activity payload.
203188

204-
<a name="error-code-SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy"></a>
205-
#### Error code: 20742 - SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy
189+
#### <a name="error-code-skipinconsistencydatanotsupportedfornondirectbinarycopy"></a> Error code: 20742 - SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy
206190

207191
- **Message**: `Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.`
208192

209193
- **Recommendation**: Remove 'dataInconsistency' of the skipErrorFile setting in the copy activity payload.
210194

211-
<a name="error-code-SkipForbiddenFileNotSupportedForNonDirectBinaryCopy"></a>
212-
#### Error code: 20743 - SkipForbiddenFileNotSupportedForNonDirectBinaryCopy
195+
#### <a name="error-code-skipforbiddenfilenotsupportedfornondirectbinarycopy"></a> Error code: 20743 - SkipForbiddenFileNotSupportedForNonDirectBinaryCopy
213196

214197
- **Message**: `Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.`
215198

216199
- **Recommendation**: Remove 'fileForbidden' of the skipErrorFile setting in the copy activity payload.
217200

218-
<a name="error-code-SkipForbiddenFileNotSupportedForThisConnector"></a>
219-
#### Error code: 20744 - SkipForbiddenFileNotSupportedForThisConnector
201+
#### <a name="error-code-skipforbiddenfilenotsupportedforthisconnector"></a> Error code: 20744 - SkipForbiddenFileNotSupportedForThisConnector
220202

221203
- **Message**: `Skip forbidden file is not supported for this connector: ('%connectorName;').`
222204

223205
- **Recommendation**: Remove 'fileForbidden' of the skipErrorFile setting in the copy activity payload.
224206

225-
<a name="error-code-SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy"></a>
226-
#### Error code: 20745 - SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy
207+
#### <a name="error-code-skipinvalidfilenamenotsupportedfornondirectbinarycopy"></a> Error code: 20745 - SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy
227208

228209
- **Message**: `Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.`
229210

230211
- **Recommendation**: Remove 'invalidFileName' of the skipErrorFile setting in the copy activity payload.
231212

232-
<a name="error-code-SkipInvalidFileNameNotSupportedForSource"></a>
233-
#### Error code: 20746 - SkipInvalidFileNameNotSupportedForSource
213+
#### <a name="error-code-skipinvalidfilenamenotsupportedforsource"></a> Error code: 20746 - SkipInvalidFileNameNotSupportedForSource
234214

235215
- **Message**: `Skip invalid file name is not supported for '%connectorName;' source.`
236216

237217
- **Recommendation**: Remove 'invalidFileName' of the skipErrorFile setting in the copy activity payload.
238218

239-
<a name="error-code-SkipInvalidFileNameNotSupportedForSink"></a>
240-
#### Error code: 20747 - SkipInvalidFileNameNotSupportedForSink
219+
#### <a name="error-code-skipinvalidfilenamenotsupportedforsink"></a> Error code: 20747 - SkipInvalidFileNameNotSupportedForSink
241220

242221
- **Message**: `Skip invalid file name is not supported for '%connectorName;' sink.`
243222

244223
- **Recommendation**: Remove 'invalidFileName' of the skipErrorFile setting in the copy activity payload.
245224

246-
<a name="error-code-SkipAllErrorFileNotSupportedForNonBinaryCopy"></a>
247-
#### Error code: 20748 - SkipAllErrorFileNotSupportedForNonBinaryCopy
225+
#### <a name="error-code-skipallerrorfilenotsupportedfornonbinarycopy"></a> Error code: 20748 - SkipAllErrorFileNotSupportedForNonBinaryCopy
248226

249227
- **Message**: `Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.`
250228

251229
- **Recommendation**: Remove 'allErrorFile' in the skipErrorFile setting in the copy activity payload.
252230

253-
<a name="error-code-DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy"></a>
254-
#### Error code: 20771 - DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy
231+
#### <a name="error-code-deletefilesaftercompletionnotsupportedfornondirectbinarycopy"></a> Error code: 20771 - DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy
255232

256233
- **Message**: `'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.`
257234

258235
- **Recommendation**: Remove the 'deleteFilesAfterCompletion' setting or use direct binary copy.
259236

260-
<a name="error-code-DeleteFilesAfterCompletionNotSupportedForThisConnector"></a>
261-
#### Error code: 20772 - DeleteFilesAfterCompletionNotSupportedForThisConnector
237+
#### <a name="error-code-deletefilesaftercompletionnotsupportedforthisconnector"></a> Error code: 20772 - DeleteFilesAfterCompletionNotSupportedForThisConnector
262238

263239
- **Message**: `'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').`
264240

265241
- **Recommendation**: Remove the 'deleteFilesAfterCompletion' setting in the copy activity payload.
266242

267-
<a name="error-code-FailedToDownloadCustomPlugins"></a>
268-
#### Error code: 27002 - FailedToDownloadCustomPlugins
243+
#### <a name="error-code-failedtodownloadcustomplugins"></a> Error code: 27002 - FailedToDownloadCustomPlugins
269244

270245
- **Message**: `Failed to download custom plugins.`
271246

@@ -275,17 +250,15 @@ The following errors are general to the copy activity and could occur with any c
275250

276251
## General connector errors
277252

278-
<a name="error-code-UserErrorOdbcInvalidQueryString"></a>
279-
#### Error code: 9611 - UserErrorOdbcInvalidQueryString
253+
#### <a name="error-code-usererrorodbcinvalidquerystring"></a> Error code: 9611 - UserErrorOdbcInvalidQueryString
280254

281255
- **Message**: `The following ODBC Query is not valid: '%'.`
282256

283257
- **Cause**: You provide a wrong or invalid query to fetch the data/schemas.
284258

285259
- **Recommendation**: Verify your query is valid and can return data/schemas. Use [Script activity](transform-data-using-script.md) if you want to execute nonquery scripts and your data store is supported. Alternatively, consider to use stored procedure that returns a dummy result to execute your nonquery scripts.
286260

287-
<a name="error-code-FailToResolveParametersInExploratoryController"></a>
288-
#### Error code: 11775 - FailToResolveParametersInExploratoryController
261+
#### Error code: 11775
289262

290263
- **Message**: `Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'`
291264

articles/data-factory/connector-troubleshoot-postgresql.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how to troubleshoot issues with the Azure Database for Postgr
55
author: jianleishen
66
ms.subservice: data-movement
77
ms.topic: troubleshooting
8-
ms.date: 10/20/2023
8+
ms.date: 01/16/2025
99
ms.author: jianleishen
1010
ms.custom: has-adal-ref, synapse
1111
---
@@ -16,15 +16,13 @@ ms.custom: has-adal-ref, synapse
1616

1717
This article provides suggestions to troubleshoot common problems with the Azure Database for PostgreSQL connector in Azure Data Factory and Azure Synapse.
1818

19-
<a name="error-code-AzurePostgreSqlNpgsqlDataTypeNotSupported"></a>
20-
## Error code: 23704 - AzurePostgreSqlNpgsqlDataTypeNotSupported
19+
## <a name="error-code-azurepostgresqlnpgsqlpartitioncolumnnamenotprovided"></a> Error code: 23704 - AzurePostgreSqlNpgsqlPartitionColumnNameNotProvided
2120

2221
- **Message**: `Partition column name must be specified.`
2322

2423
- **Cause**: No partition column name is provided, and it couldn't be decided automatically.
2524

26-
<a name="error-code-AzurePostgreSqlNpgsqlPartitionColumnNameNotProvided"></a>
27-
## Error code: 23705 - AzurePostgreSqlNpgsqlPartitionColumnNameNotProvided
25+
## <a name="error-code-azurepostgresqlnpgsqldatatypenotsupported"></a> Error code: 23705 - AzurePostgreSqlNpgsqlDataTypeNotSupported
2826

2927
- **Message**: `The data type of the chosen Partition Column, '%partitionColumn;', is '%dataType;' and this data type is not supported for partitioning.`
3028

0 commit comments

Comments
 (0)