Skip to content

Commit 93f9b99

Browse files
authored
Merge pull request #280823 from nachoalonsoportillo/add-adf-pg-error
Add entry for 11775 and replace enum names with codes (users never see enum names)
2 parents d88be49 + 18944a6 commit 93f9b99

File tree

2 files changed

+44
-44
lines changed

2 files changed

+44
-44
lines changed

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

Lines changed: 37 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ You can refer to the troubleshooting pages for each connector to see problems sp
4444

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

47-
#### Error code: JreNotFound
47+
#### Error code: 20000
4848

4949
- **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.`
5050

@@ -53,7 +53,15 @@ The errors below are general to the copy activity and could occur with any conne
5353
- **Recommendation**: Check your integration runtime environment, see [Use Self-hosted Integration Runtime](./format-parquet.md#using-self-hosted-integration-runtime).
5454

5555

56-
#### Error code: WildcardPathSinkNotSupported
56+
#### Error code: 20002
57+
58+
- **Message**: `An error occurred when invoking Java Native Interface.`
59+
60+
- **Cause**: If the error message contains "Cannot 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.
61+
62+
- **Recommendation**: Log 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.
63+
64+
#### Error code: 20020
5765

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

@@ -80,53 +88,45 @@ The errors below are general to the copy activity and could occur with any conne
8088

8189
3. Save the file, and then restart the Self-hosted IR machine.
8290

83-
#### Error code: JniException
84-
85-
- **Message**: `An error occurred when invoking Java Native Interface.`
86-
87-
- **Cause**: If the error message contains "Cannot 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.
88-
89-
- **Recommendation**: Log 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.
90-
91-
#### Error code: GetOAuth2AccessTokenErrorResponse
91+
#### Error code: 20150
9292

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

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

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

99-
#### Error code: FailedToGetOAuth2AccessToken
99+
#### Error code: 20151
100100

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

103103
- **Cause**: OAuth2 client credential flow settings are invalid.
104104

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

107-
#### Error code: OAuth2AccessTokenTypeNotSupported
107+
#### Error code: 20152
108108

109109
- **Message**: `The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.`
110110

111111
- **Cause**: Your authorization server is not supported.
112112

113113
- **Recommendation**: Use an authorization server that can return tokens with supported token types.
114114

115-
#### Error code: OAuth2ClientIdColonNotAllowed
115+
#### Error code: 20153
116116

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

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

121121
- **Recommendation**: Use a valid client ID.
122122

123-
#### Error code: ManagedIdentityCredentialObjectNotSupported
123+
#### Error code: 20523
124124

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

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

129-
#### Error code: QueryMissingFormatSettingsInDataset
129+
#### Error code: 20551
130130

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

@@ -138,99 +138,99 @@ The errors below are general to the copy activity and could occur with any conne
138138

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

141-
#### Error code: QueryUnsupportedCommandBehavior
141+
#### Error code: 20552
142142

143143
- **Message**: `The command behavior "%behavior;" is not supported.`
144144

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

147-
#### Error code: DataConsistencyFailedToGetSourceFileMetadata
147+
#### Error code: 20701
148148

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

151151
- **Cause**: There is a transient issue on the sink data store, or retrieving metadata from the sink data store is not allowed.
152152

153-
#### Error code: DataConsistencyFailedToGetSinkFileMetadata
153+
#### Error code: 20703
154154

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

157157
- **Cause**: There is a transient issue on the sink data store, or retrieving metadata from the sink data store is not allowed.
158158

159-
#### Error code: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy
159+
#### Error code: 20704
160160

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

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

165165
- **Recommendation**: Remove the 'validateDataConsistency' property in the copy activity payload.
166166

167-
#### Error code: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
167+
#### Error code: 20705
168168

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

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

173-
#### Error code: SkipMissingFileNotSupportedForNonDirectBinaryCopy
173+
#### Error code: 20741
174174

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

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

179-
#### Error code: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy
179+
#### Error code: 20742
180180

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

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

185-
#### Error code: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy
185+
#### Error code: 20743
186186

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

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

191-
#### Error code: SkipForbiddenFileNotSupportedForThisConnector
191+
#### Error code: 20744
192192

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

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

197-
#### Error code: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy
197+
#### Error code: 20745
198198

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

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

203-
#### Error code: SkipInvalidFileNameNotSupportedForSource
203+
#### Error code: 20746
204204

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

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

209-
#### Error code: SkipInvalidFileNameNotSupportedForSink
209+
#### Error code: 20747
210210

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

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

215-
#### Error code: SkipAllErrorFileNotSupportedForNonBinaryCopy
215+
#### Error code: 20748
216216

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

219219
- **Recommendation**: Remove 'allErrorFile' in the skipErrorFile setting in the copy activity payload.
220220

221-
#### Error code: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy
221+
#### Error code: 20771
222222

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

225225
- **Recommendation**: Remove the 'deleteFilesAfterCompletion' setting or use direct binary copy.
226226

227-
#### Error code: DeleteFilesAfterCompletionNotSupportedForThisConnector
227+
#### Error code: 20772
228228

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

231231
- **Recommendation**: Remove the 'deleteFilesAfterCompletion' setting in the copy activity payload.
232232

233-
#### Error code: FailedToDownloadCustomPlugins
233+
#### Error code: 27002
234234

235235
- **Message**: `Failed to download custom plugins.`
236236

@@ -240,21 +240,21 @@ The errors below are general to the copy activity and could occur with any conne
240240

241241
## General connector errors
242242

243-
#### Error code: UserErrorOdbcInvalidQueryString
243+
#### Error code: 9611
244244

245245
- **Message**: `The following ODBC Query is not valid: '%'.`
246246

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

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

251-
#### Error code: FailToResolveParametersInExploratoryController
251+
#### Error code: 11775
252252

253-
- **Message**: `The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.`
253+
- **Message**: `Failed to connect to your instance of Azure Database for PostgreSQL flexible server.`
254254

255-
- **Cause**: The service has limitation to support the linked service which references another linked service with parameters for test connection or preview data. For example, passing a parameter from a Key Vault to a linked service may occur the issue. 
255+
- **Cause**: User or password provided are incorrect. The encryption method selected is not compatible with the configuration of the server. The network connectivity method configured for your instance doesn't allow connections from the Integration Runtime selected.
256256

257-
- **Recommendation**: Remove the parameters in the referred linked service to eliminate the error. Otherwise, run the pipeline without testing connection or previewing data. 
257+
- **Recommendation**: Confirm that the user provided exists in your instance of PostgreSQL and that the password corresponds to the one currently assigned to that user. Make sure that the encryption method selected is accepted by your instance of PostgreSQL, based on its current configuration. If the network connectivity method of your instance is configured for Private access (VNet integration), use a Self-Hosted Integration Runtime (IR) to connect to it. If it is configured for Public access (allowed IP addresses), it is recommended to use an Azure IR with managed virtual network and deploy a managed private endpoint to connect to your instance. When it is configured for Public access (allowed IP addresses) a less recommended alternative consists in creating firewall rules in your instance to allow traffic originating on the IP addresses used by the Azure IR you're using.
258258

259259
## Related content
260260

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

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,18 +17,18 @@ ms.custom: has-adal-ref, synapse
1717

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

20-
## Error code: AzurePostgreSqlNpgsqlDataTypeNotSupported
21-
22-
- **Message**: `The data type of the chosen Partition Column, '%partitionColumn;', is '%dataType;' and this data type is not supported for partitioning.`
23-
24-
- **Recommendation**: Pick a partition column with int, bigint, smallint, serial, bigserial, smallserial, timestamp with or without time zone, time without time zone or date data type.
25-
26-
## Error code: AzurePostgreSqlNpgsqlPartitionColumnNameNotProvided
20+
## Error code: 23704
2721

2822
- **Message**: `Partition column name must be specified.`
2923

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

26+
## Error code: 23705
27+
28+
- **Message**: `The data type of the chosen Partition Column, '%partitionColumn;', is '%dataType;' and this data type is not supported for partitioning.`
29+
30+
- **Recommendation**: Pick a partition column with int, bigint, smallint, serial, bigserial, smallserial, timestamp with or without time zone, time without time zone or date data type.
31+
3232
## Related content
3333

3434
For more troubleshooting help, try these resources:

0 commit comments

Comments
 (0)