Development Plan

Updated on 2024-08-10 GMT+08:00

View PDF

Overview

The project uses Structured Streaming in Spark applications to call Kafka APIs to obtain word records. Word records are classified to obtain the number of records of each word.

Preparing Data

Use a user with Kafka permission to send data to Kafka. (Structured Streaming sample project data is stored in the Kafka component.)

Ensure that the cluster is installed with all the required components, namely HDFS, YARN, Spark, and Kafka.
Set the allow.everyone.if.no.acl.found parameter of Kafka Broker to true.
Create a topic.
{zkQuorum} indicates ZooKeeper cluster information in the IP address:Port number format.

$KAFKA_HOME/bin/kafka-topics.sh --create --zookeeper {zkQuorum}/kafka --replication-factor 1 --partitions 1 --topic {Topic}
Start the Producer of Kafka and send data to Kafka.
{ClassPath} indicates the storage path of the project JAR package that is specified by the user. For details, see Commissioning a Spark Application in a Linux Environment.

java -cp $SPARK_HOME/jars/*:$SPARK_HOME/jars/streamingClient010/*:{ClassPath} com.huawei.bigdata.spark.examples.KafkaWordCountProducer {BrokerList} {Topic} {messagesPerSec} {wordsPerMessage}

Development Guidelines

Receive data from Kafka and generate the corresponding DataStreamReader.
Classify word records.
Calculate and print the result.

Preparations

For clusters with the security mode enabled, the Spark Core sample code needs to read two files (user.keytab and krb5.conf). The user.keytab and krb5.conf files are authentication files in the security mode. Download the authentication credentials of the user principal on the FusionInsight Manager page. The user in the sample code is sparkuser, change the value to the prepared development user name.

Packaging the Project

Upload the user.keytab and krb5.conf files to the server where the client is located.

Use the Maven tool provided by IDEA to package the project and generate the JAR file. For details, see Commissioning a Spark Application in a Linux Environment.
NOTE:

Before compilation and packaging, change the paths of the user.keytab and krb5.conf files in the sample code to the actual paths on the client server. For example, /opt/female/user.keytab and /opt/female/krb5.conf.
Upload the JAR package to any directory (for example, /opt) on the server where the Spark client is located.
Upload commons-pool2-xxx.jar to the $SPARK_HOME/jars/streamingClient010/ directory. The JAR package can be obtained from the $SPARK_HOME/tool/carbonPrequery directory.

Running the Task

When running the sample application, you need to specify <brokers>, <subscribe-type>, <topic>, <protocol>, <service>, <domain> and <checkpointDir>. <brokers> indicates the Kafka address (port 21007 is required) for obtaining metadata, <subscribe-type> indicates the Kafka subscription type (for example, subscribe), and <topic> indicates the name of the topic read from Kafka. <protocol> indicates the secure access protocol (for example, SASL_PLAINTEXT). <service> indicates the Kerberos service name (for example, kafka). <domain> indicates the Kerberos domain name (for example, hadoop.<system domain name>), <checkpointDir> indicates the path for storing checkpoint files.
NOTE:
- The path of the Spark Structured Streaming Kafka dependency package on the client is different from that of other dependency packages. For example, the path of other dependency packages is $SPARK_HOME/jars. Whereas the path of the Spark Structured Streaming Kafka dependency package is $SPARK_HOME/jars/streamingClient010. Therefore, when running an application, you need to add a configuration item to the spark-submit command to specify the path of the dependency package of Spark Streaming Kafka, for example, --jars $(files=($SPARK_HOME/jars/streamingClient010/*.jar); IFS=,; echo "${files[*]}").
  Because the cluster's authentication is in the security mode, you need to add configuration items and modify the command parameters.
  
  Add configuration items to $SPARK_HOME/conf/jaas.conf:
  KafkaClient { com.sun.security.auth.module.Krb5LoginModule required useKeyTab=false useTicketCache=true debug=false; };
  
  Add the following configuration to the $SPARK_HOME/conf/jaas-zk.conf file:
  KafkaClient { com.sun.security.auth.module.Krb5LoginModule required useKeyTab=true keyTab="./user.keytab" principal="sparkuser@<System domain name>" useTicketCache=false storeKey=true debug=true; };
  
  Use --files and relative path to submit the keytab file to ensure that the keytab file is loaded to the container of the executor.
- When submitting a structured stream task, you need to run the --jars command to specify the path of the Kafka-related JAR file. For the current version, you need to cope the kafka-clientsjar file from the $SPARK_HOME/jars/streamingClient010 directory to the $SPARK_HOME/jars directory. Otherwise, the "class not found" error is reported.

Go to the Spark client directory and run the following commands to invoke the bin/spark-submit script to run the code (The class name and file name must be the same as those in the actual code. The following is only an example.):

Run Java or Scala sample code:
bin/spark-submit --master yarn --deploy-mode client --files <local Path>/jaas.conf,<local path>/user.keytab --jars $(files=($SPARK_HOME/jars/streamingClient010/*.jar); IFS=,; echo "${files[*]}") --class com.huawei.bigdata.spark.examples.SecurityKafkaWordCount /opt/SparkStructuredStreamingScalaExample-1.0.jar <brokers> <subscribe-type> <topic> <protocol> <service> <domain> <checkpointDir>
The configuration example is as follows:
```
-files <local Path>/jaas.conf,<local Path>/user.keytab //Use --files to specify the jaas.conf and keytab files.
```
Run the Python sample code.
NOTE:

When running the Python sample code, you need to add the JAR package of the Java project to the streamingClient010/ directory.

bin/spark-submit --master yarn --deploy-mode client --files /opt/FIclient/user.keytab --jars $(files=($SPARK_HOME/jars/streamingClient010/*.jar); IFS=,; echo "${files[*]}") /opt/female/SparkStructuredStreamingPythonExample/SecurityKafkaWordCount.py <brokers> <subscribe-type> <topic> <protocol> <service> <domain> <checkpointDir>

Parent topic: Spark Structured Streaming Sample Projects

Previous topic: Spark Structured Streaming Sample Projects

Next topic: Spark Structured Streaming Sample Project (Java)

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot