Skip to content

Commit aff04b4

Browse files
authored
Fix broken anchor links
1 parent 5a5f311 commit aff04b4

File tree

1 file changed

+55
-29
lines changed

1 file changed

+55
-29
lines changed

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

Lines changed: 55 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,8 @@ 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-
#### Error code: 2200
47+
<a name="error-code-usererrorodbcoperationFailed"></a>
48+
#### Error code: 2200 - UserErrorOdbcOperationFailed
4849

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

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

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

6062
- **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.`
6163

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

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

66-
6768
#### Error code: 20002
6869

6970
- **Message**: `An error occurred when invoking Java Native Interface.`
@@ -72,7 +73,8 @@ The following errors are general to the copy activity and could occur with any c
7273

7374
- **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.
7475

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

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

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

100102
3. Save the file, and then restart the Self-hosted IR machine.
101103

102-
#### Error code: 20150
104+
<a name="error-code-jniexception"></a>
105+
#### Error code: 20150 - JniException
103106

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

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

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

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

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

114118
- **Cause**: OAuth2 client credential flow settings are invalid.
115119

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

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

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

122127
- **Cause**: Your authorization server isn't supported.
123128

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

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

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

132138
- **Recommendation**: Use a valid client ID.
133139

134-
#### Error code: 20523
140+
<a name="error-code-ManagedIdentityCredentialObjectNotSupported"></a>
141+
#### Error code: 20523 - ManagedIdentityCredentialObjectNotSupported
135142

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

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

140-
#### Error code: 20551
147+
<a name="error-code-QueryMissingFormatSettingsInDataset"></a>
148+
#### Error code: 20551 - QueryMissingFormatSettingsInDataset
141149

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

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

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

152-
#### Error code: 20552
160+
<a name="error-code-QueryUnsupportedCommandBehavior"></a>
161+
#### Error code: 20552 - QueryUnsupportedCommandBehavior
153162

154163
- **Message**: `The command behavior "%behavior;" is not supported.`
155164

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

158-
#### Error code: 20701
167+
<a name="error-code-DataConsistencyFailedToGetSourceFileMetadata"></a>
168+
#### Error code: 20701 - DataConsistencyFailedToGetSourceFileMetadata
159169

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

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

164-
#### Error code: 20703
174+
<a name="error-code-DataConsistencyFailedToGetSinkFileMetadata"></a>
175+
#### Error code: 20703 - DataConsistencyFailedToGetSinkFileMetadata
165176

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

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

170-
#### Error code: 20704
181+
<a name="error-code-DataConsistencyValidationNotSupportedForNonDirectBinaryCopy"></a>
182+
#### Error code: 20704 - DataConsistencyValidationNotSupportedForNonDirectBinaryCopy
171183

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

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

176188
- **Recommendation**: Remove the 'validateDataConsistency' property in the copy activity payload.
177189

178-
#### Error code: 20705
190+
<a name="error-code-DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime"></a>
191+
#### Error code: 20705 - DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
179192

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

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

184-
#### Error code: 20741
197+
<a name="error-code-SkipMissingFileNotSupportedForNonDirectBinaryCopy"></a>
198+
#### Error code: 20741 - SkipMissingFileNotSupportedForNonDirectBinaryCopy
185199

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

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

190-
#### Error code: 20742
204+
<a name="error-code-SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy"></a>
205+
#### Error code: 20742 - SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy
191206

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

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

196-
#### Error code: 20743
211+
<a name="error-code-SkipForbiddenFileNotSupportedForNonDirectBinaryCopy"></a>
212+
#### Error code: 20743 - SkipForbiddenFileNotSupportedForNonDirectBinaryCopy
197213

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

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

202-
#### Error code: 20744
218+
<a name="error-code-SkipForbiddenFileNotSupportedForThisConnector"></a>
219+
#### Error code: 20744 - SkipForbiddenFileNotSupportedForThisConnector
203220

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

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

208-
#### Error code: 20745
225+
<a name="error-code-SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy"></a>
226+
#### Error code: 20745 - SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy
209227

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

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

214-
#### Error code: 20746
232+
<a name="error-code-SkipInvalidFileNameNotSupportedForSource"></a>
233+
#### Error code: 20746 - SkipInvalidFileNameNotSupportedForSource
215234

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

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

220-
#### Error code: 20747
239+
<a name="error-code-SkipInvalidFileNameNotSupportedForSink"></a>
240+
#### Error code: 20747 - SkipInvalidFileNameNotSupportedForSink
221241

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

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

226-
#### Error code: 20748
246+
<a name="error-code-SkipAllErrorFileNotSupportedForNonBinaryCopy"></a>
247+
#### Error code: 20748 - SkipAllErrorFileNotSupportedForNonBinaryCopy
227248

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

230251
- **Recommendation**: Remove 'allErrorFile' in the skipErrorFile setting in the copy activity payload.
231252

232-
#### Error code: 20771
253+
<a name="error-code-DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy"></a>
254+
#### Error code: 20771 - DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy
233255

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

236258
- **Recommendation**: Remove the 'deleteFilesAfterCompletion' setting or use direct binary copy.
237259

238-
#### Error code: 20772
260+
<a name="error-code-DeleteFilesAfterCompletionNotSupportedForThisConnector"></a>
261+
#### Error code: 20772 - DeleteFilesAfterCompletionNotSupportedForThisConnector
239262

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

242265
- **Recommendation**: Remove the 'deleteFilesAfterCompletion' setting in the copy activity payload.
243266

244-
#### Error code: 27002
267+
<a name="error-code-FailedToDownloadCustomPlugins"></a>
268+
#### Error code: 27002 - FailedToDownloadCustomPlugins
245269

246270
- **Message**: `Failed to download custom plugins.`
247271

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

252276
## General connector errors
253277

254-
#### Error code: 9611
278+
<a name="error-code-UserErrorOdbcInvalidQueryString"></a>
279+
#### Error code: 9611 - UserErrorOdbcInvalidQueryString
255280

256281
- **Message**: `The following ODBC Query is not valid: '%'.`
257282

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

260285
- **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.
261286

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

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

0 commit comments

Comments
 (0)