Update documentation for the current release (2.3.15) (#505)

This commit is contained in:
SJ 2020-04-18 01:51:19 -07:00 коммит произвёл GitHub
Родитель 5fa3f25d74
Коммит 99a0852a3d
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
5 изменённых файлов: 49 добавлений и 18 удалений

3
.github/CONTRIBUTING.md поставляемый
Просмотреть файл

@ -18,8 +18,7 @@ run all unit/integration tests and build a JAR.
### SBT Dependency
// https://mvnrepository.com/artifact/com.microsoft.azure/azure-eventhubs-spark_2.11
libraryDependencies += "com.microsoft.azure" %% "azure-eventhubs-spark" %% "2.3.13"
libraryDependencies += "com.microsoft.azure" %% "azure-eventhubs-spark" %% "2.3.15"
## Filing Issues

Просмотреть файл

@ -30,17 +30,21 @@ By making Event Hubs and Spark easier to use together, we hope this connector ma
#### Spark
|Spark Version|Package Name|Package Version|
|-------------|------------|----------------|
|Spark 2.4|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.13-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.13%7Cjar)|
|Spark 2.3|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.13-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.13%7Cjar)|
|Spark 2.4|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.15-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.15%7Cjar)|
|Spark 2.4|azure-eventhubs-spark_2.12|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.15-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.12%7C2.3.15%7Cjar)|
|Spark 2.3|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.15-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.15%7Cjar)|
|Spark 2.2|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.2.10-blue.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.2.10%7Cjar)|
|Spark 2.1|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.2.10-blue.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.2.10%7Cjar)|
#### Databricks
|Databricks Runtime Version|Artifact Id|Package Version|
|-------------|------------|----------------|
|Databricks Runtime 5.X|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.13-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.13%7Cjar)|
|Databricks Runtime 4.X|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.13-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.13%7Cjar)|
|Databricks Runtime 3.5|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.13-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.13%7Cjar)|
|Databricks Runtime 6.X|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.15-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.15%7Cjar)|
|Databricks Runtime 6.X|azure-eventhubs-spark_2.12|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.15-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.12%7C2.3.15%7Cjar)|
|Databricks Runtime 5.X|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.15-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.15%7Cjar)|
|Databricks Runtime 5.X|azure-eventhubs-spark_2.12|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.15-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.12%7C2.3.15%7Cjar)|
|Databricks Runtime 4.X|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.15-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.15%7Cjar)|
|Databricks Runtime 3.5|azure-eventhubs-spark_2.11|[![Maven Central](https://img.shields.io/badge/maven%20central-2.3.15-brightgreen.svg)](https://search.maven.org/#artifactdetails%7Ccom.microsoft.azure%7Cazure-eventhubs-spark_2.11%7C2.3.15%7Cjar)|
#### Roadmap
@ -51,11 +55,17 @@ There is an open issue for each planned feature/enhancement.
### Linking
For Scala/Java applications using SBT/Maven project definitions, link your application with the artifact below.
**Note:** See [Latest Releases](#latest-releases) to find the correct artifiact for your version of Apache Spark (or Databricks)!
**Note:** See [Latest Releases](#latest-releases) to find the correct artifact for your version of Apache Spark (or Databricks)!
groupId = com.microsoft.azure
artifactId = azure-eventhubs-spark_2.11
version = 2.3.13
version = 2.3.15
or
groupId = com.microsoft.azure
artifactId = azure-eventhubs-spark_2.12
version = 2.3.15
### Documentation

Просмотреть файл

@ -23,7 +23,13 @@ Structured streaming integration for Azure Event Hubs is ultimately run on the J
```
groupId = com.microsoft.azure
artifactId = azure-eventhubs-spark_2.11
version = 2.3.13
version = 2.3.15
or
groupId = com.microsoft.azure
artifactId = azure-eventhubs-spark_2.12
version = 2.3.15
```
For Python applications, you need to add this above library and its dependencies when deploying your application.
@ -49,6 +55,10 @@ connectionString = "YOUR.CONNECTION.STRING"
ehConf = {}
ehConf['eventhubs.connectionString'] = connectionString
For 2.3.15 version and above, the configuration dictionary requires that connection string be encrypted.
ehConf['eventhubs.connectionString'] = sc._jvm.org.apache.spark.eventhubs.EventHubsUtils.encrypt(connectionString)
```
Please read the [Connection String](#connection-string) subsection for more information on obtaining a valid
@ -387,11 +397,11 @@ AMQP types need to be handled explicitly by the connector. Below we list the AMQ
As with any Spark applications, `spark-submit` is used to launch your application. `azure-eventhubs-spark_2.11`
and its dependencies can be directly added to `spark-submit` using `--packages`, such as,
./bin/spark-submit --packages com.microsoft.azure:azure-eventhubs-spark_2.11:2.3.13 ...
./bin/spark-submit --packages com.microsoft.azure:azure-eventhubs-spark_2.11:2.3.15 ...
For experimenting on `spark-shell`, you can also use `--packages` to add `azure-eventhubs-spark_2.11` and its dependencies directly,
./bin/spark-shell --packages com.microsoft.azure:azure-eventhubs-spark_2.11:2.3.13 ...
./bin/spark-shell --packages com.microsoft.azure:azure-eventhubs-spark_2.11:2.3.15 ...
See [Application Submission Guide](https://spark.apache.org/docs/latest/submitting-applications.html) for more details about submitting
applications with external dependencies.

Просмотреть файл

@ -18,12 +18,18 @@ partitions and Spark partitions, and access to sequence numbers and metadata.
* [Deploying](#deploying)
## Linking
For Scala/Java applications using SBT/Maven project defnitions, link your application with the following artifact:
For Scala/Java applications using SBT/Maven project definitions, link your application with the following artifact:
```
groupId = com.microsoft.azure
artifactId = azure-eventhubs-spark_2.11
version = 2.3.13
version = 2.3.15
or
groupId = com.microsoft.azure
artifactId = azure-eventhubs-spark_2.12
version = 2.3.15
```
For Python applications, you need to add this above library and its dependencies when deploying your application.

Просмотреть файл

@ -18,12 +18,18 @@ Structured Streaming integration for Azure Event Hubs to read data from Event Hu
* [Deploying](#deploying)
## Linking
For Scala/Java applications using SBT/Maven project defnitions, link your application with the following artifact:
For Scala/Java applications using SBT/Maven project definitions, link your application with the following artifact:
```
groupId = com.microsoft.azure
artifactId = azure-eventhubs-spark_2.11
version = 2.3.13
version = 2.3.15
or
groupId = com.microsoft.azure
artifactId = azure-eventhubs-spark_2.12
version = 2.3.15
```
For Python applications, you need to add this above library and its dependencies when deploying your application.
@ -391,11 +397,11 @@ AMQP types need to be handled explicitly by the connector. Below we list the AMQ
As with any Spark applications, `spark-submit` is used to launch your application. `azure-eventhubs-spark_2.11`
and its dependencies can be directly added to `spark-submit` using `--packages`, such as,
./bin/spark-submit --packages com.microsoft.azure:azure-eventhubs-spark_2.11:2.3.13 ...
./bin/spark-submit --packages com.microsoft.azure:azure-eventhubs-spark_2.11:2.3.15 ...
For experimenting on `spark-shell`, you can also use `--packages` to add `azure-eventhubs-spark_2.11` and its dependencies directly,
./bin/spark-shell --packages com.microsoft.azure:azure-eventhubs-spark_2.11:2.3.13 ...
./bin/spark-shell --packages com.microsoft.azure:azure-eventhubs-spark_2.11:2.3.15 ...
See [Application Submission Guide](https://spark.apache.org/docs/latest/submitting-applications.html) for more details about submitting
applications with external dependencies.