@@ -5,7 +5,7 @@ description: Learn how to troubleshoot connector issues in Azure Data Factory an
5
5
author : jianleishen
6
6
ms.subservice : data-movement
7
7
ms.topic : troubleshooting
8
- ms.date : 09/25/2024
8
+ ms.date : 01/14/2025
9
9
ms.author : jianleishen
10
10
ms.custom : synapse
11
11
ai-usage : ai-assisted
@@ -44,8 +44,7 @@ You can refer to the troubleshooting pages for each connector to see problems sp
44
44
45
45
The following errors are general to the copy activity and could occur with any connector.
46
46
47
- <a name =" error-code-usererrorodbcoperationFailed " ></a >
48
- #### Error code: 2200 - UserErrorOdbcOperationFailed
47
+ #### <a name =" error-code-usererrorodbcoperationfailed " ></a > Error code: 2200 - UserErrorOdbcOperationFailed
49
48
50
49
- ** Message** : ` The underlying connection was closed: An unexpected error occurred on a send. `
51
50
@@ -56,25 +55,23 @@ The following errors are general to the copy activity and could occur with any c
56
55
- Check the authentication method used for the connection.
57
56
- Review firewall configuration settings for Azure Cosmos DB to ensure they allow the necessary traffic.
58
57
59
- <a name =" error-code-jrenotfound " ></a >
60
- #### Error code: 20000 - JreNotFound
58
+ #### <a name =" error-code-jrenotfound " ></a > Error code: 20000 - JreNotFound
61
59
62
60
- ** 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. `
63
61
64
62
- ** Cause** : The self-hosted IR can't find Java Runtime. Java Runtime is required for reading particular sources.
65
63
66
64
- ** Recommendation** : Check your integration runtime environment, see [ Use Self-hosted Integration Runtime] ( ./format-parquet.md#using-self-hosted-integration-runtime ) .
67
65
68
- #### Error code: 20002
66
+ #### < a name = " error-code-jniexception " ></ a > Error code: 20002 - JniException
69
67
70
68
- ** Message** : ` An error occurred when invoking Java Native Interface. `
71
69
72
70
- ** 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.
73
71
74
72
- ** 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.
75
73
76
- <a name =" error-code-wildcardpathsinknotsupported " ></a >
77
- #### Error code: 20020 - WildcardPathSinkNotSupported
74
+ #### <a name =" error-code-wildcardpathsinknotsupported " ></a > Error code: 20020 - WildcardPathSinkNotSupported
78
75
79
76
- ** Message** : ` Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'. `
80
77
@@ -101,51 +98,45 @@ The following errors are general to the copy activity and could occur with any c
101
98
102
99
3 . Save the file, and then restart the Self-hosted IR machine.
103
100
104
- <a name =" error-code-jniexception " ></a >
105
- #### Error code: 20150 - JniException
101
+ #### <a name =" error-code-getoauth2accesstokenerrorresponse " ></a > Error code: 20150 - GetOAuth2AccessTokenErrorResponse
106
102
107
103
- ** Message** : ` Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;. `
108
104
109
105
- ** Cause** : Your client ID or client secret is invalid, and the authentication failed in your authorization server.
110
106
111
107
- ** Recommendation** : Correct all OAuth2 client credential flow settings of your authorization server.
112
108
113
- <a name =" error-code-failedtogetoauth2accesstoken " ></a >
114
- #### Error code: 20151 - FailedToGetOAuth2AccessToken
109
+ #### <a name =" error-code-failedtogetoauth2accesstoken " ></a > Error code: 20151 - FailedToGetOAuth2AccessToken
115
110
116
111
- ** Message** : ` Failed to get access token from your token endpoint. Error message: %errorMessage;. `
117
112
118
113
- ** Cause** : OAuth2 client credential flow settings are invalid.
119
114
120
115
- ** Recommendation** : Correct all OAuth2 client credential flow settings of your authorization server.
121
116
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
124
118
125
119
- ** Message** : ` The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'. `
126
120
127
121
- ** Cause** : Your authorization server isn't supported.
128
122
129
123
- ** 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
133
126
134
127
- ** Message** : ` The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication. `
135
128
136
129
- ** Cause** : Your client ID includes the invalid character colon (` : ` ).
137
130
138
131
- ** Recommendation** : Use a valid client ID.
139
132
140
- <a name =" error-code-ManagedIdentityCredentialObjectNotSupported " ></a >
141
- #### Error code: 20523 - ManagedIdentityCredentialObjectNotSupported
133
+ #### <a name =" error-code-managedidentitycredentialobjectnotsupported " ></a > Error code: 20523 - ManagedIdentityCredentialObjectNotSupported
142
134
143
135
- ** Message** : ` Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime. `
144
136
145
137
- ** Recommendation** : Check the supported version and upgrade the integration runtime to a higher version.
146
138
147
- <a name =" error-code-QueryMissingFormatSettingsInDataset " ></a >
148
- #### Error code: 20551 - QueryMissingFormatSettingsInDataset
139
+ #### <a name =" error-code-querymissingformatsettingsindataset " ></a > Error code: 20551 - QueryMissingFormatSettingsInDataset
149
140
150
141
- ** Message** : ` The format settings are missing in dataset %dataSetName;. `
151
142
@@ -157,115 +148,99 @@ The following errors are general to the copy activity and could occur with any c
157
148
158
149
- ** Recommendation** : Deselect the "Binary copy" in the dataset, and set correct format settings.
159
150
160
- <a name =" error-code-QueryUnsupportedCommandBehavior " ></a >
161
- #### Error code: 20552 - QueryUnsupportedCommandBehavior
151
+ #### <a name =" error-code-queryunsupportedcommandbehavior " ></a > Error code: 20552 - QueryUnsupportedCommandBehavior
162
152
163
153
- ** Message** : ` The command behavior "%behavior;" is not supported. `
164
154
165
155
- ** Recommendation** : Don't add the command behavior as a parameter for preview or GetSchema API request URL.
166
156
167
- <a name =" error-code-DataConsistencyFailedToGetSourceFileMetadata " ></a >
168
- #### Error code: 20701 - DataConsistencyFailedToGetSourceFileMetadata
157
+ #### <a name =" error-code-dataconsistencyfailedtogetsourcefilemetadata " ></a > Error code: 20701 - DataConsistencyFailedToGetSourceFileMetadata
169
158
170
159
- ** Message** : ` Failed to retrieve source file ('%name;') metadata to validate data consistency. `
171
160
172
161
- ** Cause** : There's a transient issue on the sink data store, or retrieving metadata from the sink data store isn't allowed.
173
162
174
- <a name =" error-code-DataConsistencyFailedToGetSinkFileMetadata " ></a >
175
- #### Error code: 20703 - DataConsistencyFailedToGetSinkFileMetadata
163
+ #### <a name =" error-code-dataconsistencyfailedtogetsinkfilemetadata " ></a > Error code: 20703 - DataConsistencyFailedToGetSinkFileMetadata
176
164
177
165
- ** Message** : ` Failed to retrieve sink file ('%name;') metadata to validate data consistency. `
178
166
179
167
- ** Cause** : There's a transient issue on the sink data store, or retrieving metadata from the sink data store isn't allowed.
180
168
181
- <a name =" error-code-DataConsistencyValidationNotSupportedForNonDirectBinaryCopy " ></a >
182
- #### Error code: 20704 - DataConsistencyValidationNotSupportedForNonDirectBinaryCopy
169
+ #### <a name =" error-code-dataconsistencyvalidationnotsupportedfornondirectbinarycopy " ></a > Error code: 20704 - DataConsistencyValidationNotSupportedForNonDirectBinaryCopy
183
170
184
171
- ** Message** : ` Data consistency validation is not supported in current copy activity settings. `
185
172
186
173
- ** Cause** : The data consistency validation is only supported in the direct binary copy scenario.
187
174
188
175
- ** Recommendation** : Remove the 'validateDataConsistency' property in the copy activity payload.
189
176
190
- <a name =" error-code-DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime " ></a >
191
- #### Error code: 20705 - DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
177
+ #### <a name =" error-code-dataconsistencyvalidationnotsupportedforlowversionselfhostedintegrationruntime " ></a > Error code: 20705 - DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
192
178
193
179
- ** Message** : ` 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime. `
194
180
195
181
- ** Recommendation** : Check the supported integration runtime version and upgrade it to a higher version, or remove the 'validateDataConsistency' property from copy activities.
196
182
197
- <a name =" error-code-SkipMissingFileNotSupportedForNonDirectBinaryCopy " ></a >
198
- #### Error code: 20741 - SkipMissingFileNotSupportedForNonDirectBinaryCopy
183
+ #### <a name =" error-code-skipmissingfilenotsupportedfornondirectbinarycopy " ></a > Error code: 20741 - SkipMissingFileNotSupportedForNonDirectBinaryCopy
199
184
200
185
- ** Message** : ` Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder. `
201
186
202
187
- ** Recommendation** : Remove 'fileMissing' of the skipErrorFile setting in the copy activity payload.
203
188
204
- <a name =" error-code-SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy " ></a >
205
- #### Error code: 20742 - SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy
189
+ #### <a name =" error-code-skipinconsistencydatanotsupportedfornondirectbinarycopy " ></a > Error code: 20742 - SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy
206
190
207
191
- ** Message** : ` Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true. `
208
192
209
193
- ** Recommendation** : Remove 'dataInconsistency' of the skipErrorFile setting in the copy activity payload.
210
194
211
- <a name =" error-code-SkipForbiddenFileNotSupportedForNonDirectBinaryCopy " ></a >
212
- #### Error code: 20743 - SkipForbiddenFileNotSupportedForNonDirectBinaryCopy
195
+ #### <a name =" error-code-skipforbiddenfilenotsupportedfornondirectbinarycopy " ></a > Error code: 20743 - SkipForbiddenFileNotSupportedForNonDirectBinaryCopy
213
196
214
197
- ** Message** : ` Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder. `
215
198
216
199
- ** Recommendation** : Remove 'fileForbidden' of the skipErrorFile setting in the copy activity payload.
217
200
218
- <a name =" error-code-SkipForbiddenFileNotSupportedForThisConnector " ></a >
219
- #### Error code: 20744 - SkipForbiddenFileNotSupportedForThisConnector
201
+ #### <a name =" error-code-skipforbiddenfilenotsupportedforthisconnector " ></a > Error code: 20744 - SkipForbiddenFileNotSupportedForThisConnector
220
202
221
203
- ** Message** : ` Skip forbidden file is not supported for this connector: ('%connectorName;'). `
222
204
223
205
- ** Recommendation** : Remove 'fileForbidden' of the skipErrorFile setting in the copy activity payload.
224
206
225
- <a name =" error-code-SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy " ></a >
226
- #### Error code: 20745 - SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy
207
+ #### <a name =" error-code-skipinvalidfilenamenotsupportedfornondirectbinarycopy " ></a > Error code: 20745 - SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy
227
208
228
209
- ** Message** : ` Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder. `
229
210
230
211
- ** Recommendation** : Remove 'invalidFileName' of the skipErrorFile setting in the copy activity payload.
231
212
232
- <a name =" error-code-SkipInvalidFileNameNotSupportedForSource " ></a >
233
- #### Error code: 20746 - SkipInvalidFileNameNotSupportedForSource
213
+ #### <a name =" error-code-skipinvalidfilenamenotsupportedforsource " ></a > Error code: 20746 - SkipInvalidFileNameNotSupportedForSource
234
214
235
215
- ** Message** : ` Skip invalid file name is not supported for '%connectorName;' source. `
236
216
237
217
- ** Recommendation** : Remove 'invalidFileName' of the skipErrorFile setting in the copy activity payload.
238
218
239
- <a name =" error-code-SkipInvalidFileNameNotSupportedForSink " ></a >
240
- #### Error code: 20747 - SkipInvalidFileNameNotSupportedForSink
219
+ #### <a name =" error-code-skipinvalidfilenamenotsupportedforsink " ></a > Error code: 20747 - SkipInvalidFileNameNotSupportedForSink
241
220
242
221
- ** Message** : ` Skip invalid file name is not supported for '%connectorName;' sink. `
243
222
244
223
- ** Recommendation** : Remove 'invalidFileName' of the skipErrorFile setting in the copy activity payload.
245
224
246
- <a name =" error-code-SkipAllErrorFileNotSupportedForNonBinaryCopy " ></a >
247
- #### Error code: 20748 - SkipAllErrorFileNotSupportedForNonBinaryCopy
225
+ #### <a name =" error-code-skipallerrorfilenotsupportedfornonbinarycopy " ></a > Error code: 20748 - SkipAllErrorFileNotSupportedForNonBinaryCopy
248
226
249
227
- ** Message** : ` Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder. `
250
228
251
229
- ** Recommendation** : Remove 'allErrorFile' in the skipErrorFile setting in the copy activity payload.
252
230
253
- <a name =" error-code-DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy " ></a >
254
- #### Error code: 20771 - DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy
231
+ #### <a name =" error-code-deletefilesaftercompletionnotsupportedfornondirectbinarycopy " ></a > Error code: 20771 - DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy
255
232
256
233
- ** Message** : ` 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy. `
257
234
258
235
- ** Recommendation** : Remove the 'deleteFilesAfterCompletion' setting or use direct binary copy.
259
236
260
- <a name =" error-code-DeleteFilesAfterCompletionNotSupportedForThisConnector " ></a >
261
- #### Error code: 20772 - DeleteFilesAfterCompletionNotSupportedForThisConnector
237
+ #### <a name =" error-code-deletefilesaftercompletionnotsupportedforthisconnector " ></a > Error code: 20772 - DeleteFilesAfterCompletionNotSupportedForThisConnector
262
238
263
239
- ** Message** : ` 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;'). `
264
240
265
241
- ** Recommendation** : Remove the 'deleteFilesAfterCompletion' setting in the copy activity payload.
266
242
267
- <a name =" error-code-FailedToDownloadCustomPlugins " ></a >
268
- #### Error code: 27002 - FailedToDownloadCustomPlugins
243
+ #### <a name =" error-code-failedtodownloadcustomplugins " ></a > Error code: 27002 - FailedToDownloadCustomPlugins
269
244
270
245
- ** Message** : ` Failed to download custom plugins. `
271
246
@@ -275,17 +250,15 @@ The following errors are general to the copy activity and could occur with any c
275
250
276
251
## General connector errors
277
252
278
- <a name =" error-code-UserErrorOdbcInvalidQueryString " ></a >
279
- #### Error code: 9611 - UserErrorOdbcInvalidQueryString
253
+ #### <a name =" error-code-usererrorodbcinvalidquerystring " ></a > Error code: 9611 - UserErrorOdbcInvalidQueryString
280
254
281
255
- ** Message** : ` The following ODBC Query is not valid: '%'. `
282
256
283
257
- ** Cause** : You provide a wrong or invalid query to fetch the data/schemas.
284
258
285
259
- ** 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.
286
260
287
- <a name =" error-code-FailToResolveParametersInExploratoryController " ></a >
288
- #### Error code: 11775 - FailToResolveParametersInExploratoryController
261
+ #### Error code: 11775
289
262
290
263
- ** Message** : ` Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%' `
291
264
0 commit comments